ServiceDescriptionImporter.AddServiceDescription Méthode

Définition

Espace de noms:

System.Web.Services.Description

Assembly:

System.Web.Services.dll

Ajoute le ServiceDescription spécifié à la collection de valeurs ServiceDescriptions à importer.

public:
 void AddServiceDescription(System::Web::Services::Description::ServiceDescription ^ serviceDescription, System::String ^ appSettingUrlKey, System::String ^ appSettingBaseUrl);

public void AddServiceDescription (System.Web.Services.Description.ServiceDescription serviceDescription, string appSettingUrlKey, string appSettingBaseUrl);

member this.AddServiceDescription : System.Web.Services.Description.ServiceDescription * string * string -> unit

Public Sub AddServiceDescription (serviceDescription As ServiceDescription, appSettingUrlKey As String, appSettingBaseUrl As String)

Paramètres

serviceDescription

ServiceDescription

Instance de ServiceDescription à ajouter à la collection.

appSettingUrlKey

String

Définit la valeur initiale de la propriété Url de la classe proxy à générer à partir de l'instance représentée par le paramètre serviceDescription. Spécifie qu'elle doit être générée à partir de la section <appsetting> du fichier web.config.

appSettingBaseUrl

String

Définit la valeur initiale de la propriété Url de la classe proxy à générer à partir de l'instance représentée par le paramètre serviceDescription. Spécifie qu'elle doit être créée à partir d'une combinaison de la valeur de ce paramètre et de l'URL spécifiée par l'attribut location dans le document WSDL.

Exemples

L’exemple suivant illustre l’utilisation de la méthode lors de l’utilisation AddServiceDescription de la ServiceDescriptionImporter classe .

// Initialize a service description importer.
ServiceDescriptionImporter^ importer = gcnew ServiceDescriptionImporter;
importer->ProtocolName = "Soap12"; // Use SOAP 1.2.
importer->AddServiceDescription( description, nullptr, nullptr );

// Initialize a service description importer.
ServiceDescriptionImporter importer = new ServiceDescriptionImporter();
importer.ProtocolName = "Soap12";  // Use SOAP 1.2.
importer.AddServiceDescription(description,null,null);

Remarques

Utilisez cette méthode pour ajouter ServiceDescription des instances à la collection qui doit être importée lorsque la Import méthode est appelée.

Les deux paramètres de chaîne, appSettingUrlKey et appSettingBaseUrl, spécifient comment construire la Url propriété du proxy de service Web XML qui doit être générée à partir de la valeur importée ServiceDescription . Le appSettingUrlKey paramètre spécifie que la Url propriété doit être lue dans la section du fichier web.config en utilisant la valeur du <appsettings> paramètre comme clé de configuration. Si le appSettingUrlKey paramètre est null ou une chaîne vide, la valeur initiale est déterminée par l’attribut location dans le document WSDL (Web Services Description Language). Si la valeur de Style est Server, une erreur est générée si vous tentez de définir la valeur du appSettingUrlKey paramètre.

Le appSettingBaseUrl paramètre spécifie que la valeur initiale de la Url propriété doit être construite à partir d’une combinaison de cette valeur de paramètre et de l’URL spécifiée par l’attribut location dans le document WSDL. Le appSettingUrlKey paramètre doit également être spécifié. La Url propriété est construite en combinant une URL relative (construite à partir du appSettingBaseUrl paramètre et de l’URL spécifiée par WSDL) avec l’URL chargée à partir du fichier web.config. Si ce paramètre est null ou une chaîne vide, l’URL est entièrement construite à partir de la valeur dans le fichier web.config.