ServiceDescriptionImporter.AddServiceDescription Метод

Определение

Пространство имен:

System.Web.Services.Description

Сборка:

System.Web.Services.dll

Добавляет указанный объект ServiceDescription в коллекцию импортируемых значений свойства ServiceDescriptions.

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)

Параметры

serviceDescription

ServiceDescription

Экземпляр ServiceDescription, добавляемый в коллекцию.

appSettingUrlKey

String

Задает исходное значение свойства Url прокси-класса, которое требуется создать на основе экземпляра, представленного параметром serviceDescription. Указывает, что его следует создать на основе раздела <appsetting> файла web.config.

appSettingBaseUrl

String

Задает исходное значение свойства Url прокси-класса, которое требуется создать на основе экземпляра, представленного параметром serviceDescription. Указывает, что оно должно быть создано на основе сочетания значения этого параметра и URL-адреса, заданного атрибутом location в документе WSDL.

Примеры

В следующем примере показано использование AddServiceDescription метода при использовании ServiceDescriptionImporter класса .

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

Комментарии

Используйте этот метод для добавления ServiceDescription экземпляров в коллекцию, которая будет импортирована при вызове Import метода .

Два строковых параметра, appSettingUrlKey и appSettingBaseUrl, указывают, как создать Url свойство прокси-сервера веб-службы XML, которое должно быть создано на основе импортированного ServiceDescription значения. Параметр appSettingUrlKey указывает, что Url свойство должно считываться из раздела файла <appsettings> web.config, используя значение параметра в качестве ключа конфигурации. appSettingUrlKey Если параметр имеет null значение или является пустой строкой, начальное значение определяется атрибутом location в документе WSDL. Если значение Style равно Server, при попытке задать значение appSettingUrlKey параметра возникает ошибка.

Параметр appSettingBaseUrl указывает, что начальное значение Url свойства должно быть создано на основе сочетания этого значения параметра и URL-адреса, указанного location атрибутом в документе WSDL. Также appSettingUrlKey необходимо указать параметр . Свойство Url создается путем объединения относительного URL-адреса (созданного appSettingBaseUrl на основе параметра и url-адреса, указанного в WSDL) с URL-адресом, загруженным из файла web.config. Если этот параметр является null или пустой строкой, URL-адрес создается полностью на основе значения в файле web.config.