Click or drag to resize
Register Class
Implements the XmlLicenseService web service's Register method to update customer registration information.
Inheritance Hierarchy

Namespace: com.softwarekey.Client.WebService.XmlLicenseService
Assembly: PLUSManaged (in PLUSManaged.dll) Version: 5.23.4.0
Syntax
public class Register : WebServiceCall

The Register type exposes the following members.

Constructors
  NameDescription
Public methodRegister
Creates a new Register object.
Public methodRegister(XmlLicenseService)
Creates a new Register object with a specified web service client (XmlLicenseService) object.
Top
Properties
  NameDescription
Public propertyAddress1
Gets or sets the customer's street address (or line 1 of the customer's address).
Public propertyAddress2
Gets or sets the customer's second address line (i.e. apartment or suite number).
Public propertyCity
Gets or sets the city of the customer's address.
Public propertyClassName
Gets or sets the class name of the WebServiceClient object.
(Inherited from WebServiceCall.)
Public propertyCompany
Gets or sets the customer's company name.
Public propertyCountry
Gets or sets the country of the customer's address.
Public propertyCustomerID
Gets the Customer ID to which the License ID belongs.
Public propertyEmail
Gets or sets the customer's email address.
Public propertyEncryptionKey
Gets or sets the author encryption key data.
(Inherited from WebServiceCall.)
Public propertyErrorMessage
Gets or sets the error message returned by the web service method call. (See http://www.softwarekey.com/go/?ID=20 for a list of possible values.)
(Inherited from WebServiceCall.)
Public propertyEuropeanUnionVATNumber
Gets or sets the customer's European Union VAT number.
Public propertyFax
Gets or sets the customer's fax number.
Public propertyFirstName
Gets or sets the customer's first name.
Public propertyLastError
Gets or sets the last error which occurred.
(Inherited from WebServiceCall.)
Public propertyLastName
Gets or sets the customer's last name.
Public propertyLicenseeEmail
Gets or sets the licensee's email address.
Public propertyLicenseeName
Gets or sets the licensee's name.
Public propertyLicenseID
Gets or sets the License ID (requires a value for the Password property when non-zero).
Public propertyMethodName
Gets or sets the name of the method which will be called from the WebServiceClient object.
(Inherited from WebServiceCall.)
Public propertyNewPassword
Gets or sets the customer's new password (leave empty unless you need to reset the customer's password).
Public propertyNotes
Gets or sets notes about the customer.
Public propertyPassword
Gets or sets the password (required when LicenseID is set to a non-zero value). This may be set to the activation password assigned to the license, or the customer password, in SOLO Server.
Public propertyPhone
Gets or sets the customer's phone number.
Public propertyPostalCode
Gets or sets the customer's zip/postal code.
Public propertyProductID
Gets or sets the Product ID (required when SerialNumber is not empty).
Public propertyRequireSsl
Gets or sets whether or not SSL certificate validation to check.
(Inherited from WebServiceCall.)
Public propertyResultCode
Gets or sets the result code returned by the web service method call. (See http://www.softwarekey.com/go/?ID=20 for a list of possible values.)
(Inherited from WebServiceCall.)
Public propertySerialNumber
Gets or sets the Serial number (requires a value for the ProductID property when not empty).
Public propertySessionCode
Gets or sets the randomized session code (used to deter replay attacks).
(Inherited from WebServiceCall.)
Public propertySessionCodeValidation
Gets or sets whether or not session code validation should be done automatically.
(Inherited from WebServiceCall.)
Public propertyStateProvince
Gets or sets the state/province of the customer's address.
Public propertyUseDigitalSignature
Overrides the UseDigitalSignature property to reflect the fact that this web service method does not support digital signatures.
(Overrides WebServiceCallUseDigitalSignature.)
Public propertyUseEncryption
Overrides the UseEncryption property to reflect the fact that this web service method does not support encryption.
(Overrides WebServiceCallUseEncryption.)
Public propertyWebServiceClient
Gets or sets the SoapHttpClientProtocol object (.NET Framework) or the XmlWebService object (.NET Standard 2.0) used to perform the web service method call.
(Inherited from WebServiceCall.)
Public propertyWebServiceResponse
Gets or set the XmlNode object reference for the root XML node of the web service response.
(Inherited from WebServiceCall.)
Top
Methods
  NameDescription
Protected methodAppendSessionCode(String)
Appends the SessionCode value to an XML request string depending on the SessionCodeValidation setting, and returns the updated XML string
(Inherited from WebServiceCall.)
Protected methodAppendSessionCode(XmlDocument)
Appends the SessionCode value to an XmlDocument depending on the SessionCodeValidation setting, and returns the updated XML string
(Inherited from WebServiceCall.)
Public methodCallWebService
Calls the web service method.
(Inherited from WebServiceCall.)
Public methodEquals
Determines whether the specified Object is equal to the current Object.
(Inherited from Object.)
Protected methodFinalize
Allows an Object to attempt to free resources and perform other cleanup operations before the Object is reclaimed by garbage collection.
(Inherited from Object.)
Public methodGenerateEncryptedRequest
Generates an encrypted web service call XML request string.
(Inherited from WebServiceCall.)
Public methodGeneratePlainTextRequest
Generates a plain-text XML request string for Register calls
(Overrides WebServiceCallGeneratePlainTextRequest.)
Public methodGetHashCode
Serves as a hash function for a particular type.
(Inherited from Object.)
Public methodGetType
Gets the Type of the current instance.
(Inherited from Object.)
Protected methodMemberwiseClone
Creates a shallow copy of the current Object.
(Inherited from Object.)
Public methodProcessResponse(String)
Processes a web service response XML string.
(Inherited from WebServiceCall.)
Public methodProcessResponse(XmlNode) (Overrides WebServiceCallProcessResponse(XmlNode).)
Public methodResetSessionCode
Sets the SessionCode value to a new, randomized value.
(Inherited from WebServiceCall.)
Public methodToString
Returns a String that represents the current Object.
(Inherited from Object.)
Public methodValidateWebServiceResponseFormat
Verifies the format of the response received is such that expected and required content can be found and parsed.
(Inherited from WebServiceCall.)
Top
Remarks

The XmlLicenseService documentation should be referenced for the most current information.

Note Note

This function will only update a customer's registration if the customer is not already registered. If you wish to update registration details even when the customer is already registered, use UpdateRegistration instead.

Note Note

Before calling the CallWebService method, the LicenseID and Password properties must be set, or the SerialNumber and ProductID properties must be set.

Examples
This example shows how to make a basic Register call
public bool RegisterCustomer(int licenseID, string password, string company, string firstName, string lastName, string email)
{
    Register registration = new Register();
    registration.LicenseID = licenseID;
    registration.Password = password;
    registration.Company = company;
    registration.FirstName = firstName;
    registration.LastName = lastName;
    registration.Email = email;

    if (!registration.CallWebService())
    {
        //TODO: check the LastError property and add error reporting here!
        return false;
    }

    //TODO: Add your custom, post-registration logic here!

    return true;
}
See Also