ServiceDescriptionImporter.AddServiceDescription Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Добавляет указанный объект 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.