ServiceDescriptionImporter.AddServiceDescription Methode

Definition

Fügt die angegebene ServiceDescription Auflistung der ServiceDescriptions zu importierenden 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 ServiceDescription Instanz, die der Auflistung hinzugefügt werden soll.

appSettingUrlKey
String

Legt den Anfangswert der Url Eigenschaft der Proxyklasse fest, die aus der instanz generiert werden soll, die durch den serviceDescription Parameter dargestellt wird. Gibt an, dass sie aus dem Abschnitt web.config Datei <appsetting> generiert werden soll.

appSettingBaseUrl
String

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

Beispiele

Das folgende Beispiel veranschaulicht die Verwendung der AddServiceDescription Methode bei Verwendung der ServiceDescriptionImporter Klasse.

// 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 appSettingUrlKey, geben an, appSettingBaseUrl wie die Url Eigenschaft des XML-Webdienstproxys erstellt werden soll, die aus dem importierten ServiceDescription Wert generiert werden soll. Der appSettingUrlKey Parameter gibt an, dass die Url Eigenschaft aus dem Abschnitt web.config Datei mithilfe des Parameterwerts <appsettings> als Konfigurationsschlüssel ausgelesen werden soll. 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 lautet StyleServer, 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 dieses Parameterwerts und der durch das location Attribut im WSDL-Dokument angegebenen URL erstellt werden soll. Der appSettingUrlKey Parameter muss ebenfalls angegeben werden. Die Url Eigenschaft wird erstellt, indem eine relative URL (erstellt aus dem appSettingBaseUrl Parameter und der WSDL-angegebenen URL) mit der URL kombiniert wird, die aus der web.config Datei geladen wurde. Wenn dieser Parameter oder eine leere Zeichenfolge ist null , wird die URL vollständig aus dem Wert in der web.config-Datei erstellt.

Gilt für: