ServiceDescriptionImporter.AddServiceDescription Methode

Definition

Namespace:

System.Web.Services.Description

Assembly:

System.Web.Services.dll

Fügt die angegebene ServiceDescription der Auflistung zu importierender ServiceDescriptions-Werte hinzu.

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)

Parameter

serviceDescription

ServiceDescription

Die der Auflistung hinzuzufügende ServiceDescription-Instanz.

appSettingUrlKey

String

Legt den Anfangswert der Url-Eigenschaft der Proxyklasse fest, die aus der durch den serviceDescription-Parameter dargestellten Instanz erstellt werden soll. Gibt an, dass diese aus dem <appsetting>-Abschnitt der Datei web.config erstellt werden soll.

appSettingBaseUrl

String

Legt den Anfangswert der Url-Eigenschaft der Proxyklasse fest, die aus der durch den serviceDescription-Parameter dargestellten Instanz erstellt werden soll. Gibt an, dass diese aus einer Kombination des Werts dieses Parameters und der URL erstellt werden soll, die durch das location-Attribut im WSDL-Dokument angegeben wird.

Beispiele

Im folgenden Beispiel wird die Verwendung der AddServiceDescription -Methode bei Verwendung der ServiceDescriptionImporter -Klasse veranschaulicht.

// 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);

Hinweise

Verwenden Sie diese Methode, um der Auflistung Instanzen hinzuzufügen ServiceDescription , die importiert werden sollen, wenn die Import Methode aufgerufen wird.

Die beiden Zeichenfolgenparameter und appSettingBaseUrlgeben an, appSettingUrlKey wie die Url Eigenschaft des XML-Webdienstproxys erstellt wird, die aus dem importierten ServiceDescription Wert generiert werden soll. Der appSettingUrlKey Parameter gibt an, dass die Url -Eigenschaft aus dem Abschnitt der web.config-Datei <appsettings> gelesen werden soll, indem der Parameterwert als Konfigurationsschlüssel verwendet wird. Wenn der appSettingUrlKey Parameter oder eine leere Zeichenfolge ist null , wird der Anfangswert durch das location -Attribut im WSDL-Dokument (Web Services Description Language) bestimmt. Wenn der Wert von Style ist Server, wird ein Fehler ausgelöst, wenn Sie versuchen, den Wert des appSettingUrlKey Parameters festzulegen.

Der appSettingBaseUrl Parameter gibt an, dass der Anfangswert für die Url Eigenschaft aus einer Kombination aus diesem Parameterwert und der URL erstellt werden soll, die durch das location Attribut im WSDL-Dokument angegeben wird. Der appSettingUrlKey Parameter muss ebenfalls angegeben werden. Die Url -Eigenschaft wird erstellt, indem eine relative URL (erstellt aus dem appSettingBaseUrl Parameter und der von WSDL angegebenen URL) mit der URL kombiniert wird, die aus der web.config-Datei geladen wird. Wenn es sich bei diesem Parameter null um eine leere Zeichenfolge handelt, wird die URL vollständig aus dem Wert in der web.config-Datei erstellt.