ServiceDescriptionImporter.AddServiceDescription-Methode

Artikel
08/20/2007

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

Namespace: System.Web.Services.Description
Assembly: System.Web.Services (in system.web.services.dll)

Syntax

'Declaration
Public Sub AddServiceDescription ( _
    serviceDescription As ServiceDescription, _
    appSettingUrlKey As String, _
    appSettingBaseUrl As String _
)
'Usage
Dim instance As ServiceDescriptionImporter
Dim serviceDescription As ServiceDescription
Dim appSettingUrlKey As String
Dim appSettingBaseUrl As String

instance.AddServiceDescription(serviceDescription, appSettingUrlKey, appSettingBaseUrl)

public void AddServiceDescription (
    ServiceDescription serviceDescription,
    string appSettingUrlKey,
    string appSettingBaseUrl
)

public:
void AddServiceDescription (
    ServiceDescription^ serviceDescription, 
    String^ appSettingUrlKey, 
    String^ appSettingBaseUrl
)

public void AddServiceDescription (
    ServiceDescription serviceDescription, 
    String appSettingUrlKey, 
    String appSettingBaseUrl
)

public function AddServiceDescription (
    serviceDescription : ServiceDescription, 
    appSettingUrlKey : String, 
    appSettingBaseUrl : String
)

Parameter

serviceDescription
Die der Auflistung hinzuzufügende ServiceDescription-Instanz.

appSettingUrlKey
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
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 des URLs erstellt werden soll, der durch das location-Attribut im WSDL-Dokument angegeben wird.

Hinweise

Verwenden Sie diese Methode, um der beim Aufrufen der Import-Methode zu importierenden Auflistung ServiceDescription-Instanzen hinzuzufügen.

Die beiden Zeichenfolgenparameter (appSettingUrlKey und appSettingBaseUrl) geben an, wie die Url-Eigenschaft des XML-Webdienstproxys erstellt wird, der anhand des importierten ServiceDescription-Werts generiert werden soll. Der appSettingUrlKey-Parameter gibt an, dass die Url-Eigenschaft mit dem Wert des Parameters als Konfigurationsschlüssel aus dem <appsettings>-Abschnitt der Datei web.config gelesen werden soll. Wenn der appSettingUrlKey-Parameter NULL (Nothing in Visual Basic) oder eine leere Zeichenfolge ist, wird der Anfangswert durch das location-Attribut im WSDL-Dokument (Web Services Description Language -Dokument) bestimmt. Wenn der Wert von Style auf Server festgelegt ist, wird bei dem Versuch, den Wert auf den appSettingUrlKey-Parameter festzulegen, ein Fehler ausgelöst.

Der appSettingBaseUrl-Parameter gibt an, dass der Anfangswert für die Url-Eigenschaft aus einer Kombination dieses Parameterwerts und des URLs erstellt werden muss, der durch das location-Attribut im WSDL-Dokument angegeben wird. Der appSettingUrlKey-Parameter muss ebenfalls angegeben werden. Die Url-Eigenschaft wird erstellt, indem ein relativer URL (erstellt aus dem appSettingBaseUrl-Parameter und dem in WSDL angegebenen URL) mit dem aus der Datei web.config geladenen URL kombiniert wird. Wenn dieser Parameter NULL (Nothing in Visual Basic) oder eine leere Zeichenfolge ist, wird der URL ausschließlich aus dem Wert in der Datei web.config erstellt.

Beispiel

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

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

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

Plattformen

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

ServiceDescriptionImporter-Klasse
ServiceDescriptionImporter-Member
System.Web.Services.Description-Namespace

Freigeben über