ServiceDescription Класс

Определение

Предоставляет средства создания и форматирования допустимого файла документа языка описания веб-служб (WSDL), в комплекте с соответствующими пространствами имен, элементами и атрибутами для описания веб-службы XML. Этот класс не наследуется.

public ref class ServiceDescription sealed : System::Web::Services::Description::DocumentableItem
public ref class ServiceDescription sealed : System::Web::Services::Description::NamedItem
[System.Web.Services.Configuration.XmlFormatExtensionPoint("Extensions")]
public sealed class ServiceDescription : System.Web.Services.Description.DocumentableItem
[System.Web.Services.Configuration.XmlFormatExtensionPoint("Extensions")]
public sealed class ServiceDescription : System.Web.Services.Description.NamedItem
[<System.Web.Services.Configuration.XmlFormatExtensionPoint("Extensions")>]
type ServiceDescription = class
    inherit DocumentableItem
[<System.Web.Services.Configuration.XmlFormatExtensionPoint("Extensions")>]
type ServiceDescription = class
    inherit NamedItem
Public NotInheritable Class ServiceDescription
Inherits DocumentableItem
Public NotInheritable Class ServiceDescription
Inherits NamedItem
Наследование
ServiceDescription
Наследование
ServiceDescription
Атрибуты

Примеры

В следующем примере показано, как создать экземпляр ServiceDescription класса.

// Obtain the ServiceDescription of existing Wsdl.
ServiceDescription^ myDescription = ServiceDescription::Read( "MyWsdl_CS.wsdl" );

// Remove the Binding from the Binding Collection of ServiceDescription.
BindingCollection^ myBindingCollection = myDescription->Bindings;
myBindingCollection->Remove( myBindingCollection[ 0 ] );

// Form a new Binding.
Binding^ myBinding = gcnew Binding;
myBinding->Name = "Service1Soap";
XmlQualifiedName^ myXmlQualifiedName = gcnew XmlQualifiedName( "s0:Service1Soap" );
myBinding->Type = myXmlQualifiedName;
SoapBinding^ mySoapBinding = gcnew SoapBinding;
mySoapBinding->Transport = "http://schemas.xmlsoap.org/soap/http";
mySoapBinding->Style = SoapBindingStyle::Document;
OperationBinding^ addOperationBinding = CreateOperationBinding( "Add", myDescription->TargetNamespace );
myBinding->Operations->Add( addOperationBinding );
myBinding->Extensions->Add( mySoapBinding );

// Add the Binding to the ServiceDescription.
myDescription->Bindings->Add( myBinding );
myDescription->Write( "MyOutWsdl.wsdl" );
// Obtain the ServiceDescription of existing Wsdl.
ServiceDescription myDescription = ServiceDescription.Read("MyWsdl_CS.wsdl");
// Remove the Binding from the Binding Collection of ServiceDescription.
BindingCollection myBindingCollection = myDescription.Bindings;
myBindingCollection.Remove(myBindingCollection[0]);

// Form a new Binding.
Binding myBinding = new Binding();
myBinding.Name = "Service1Soap";
XmlQualifiedName myXmlQualifiedName =
                     new XmlQualifiedName("s0:Service1Soap");
myBinding.Type = myXmlQualifiedName;

SoapBinding mySoapBinding = new SoapBinding();
mySoapBinding.Transport = "http://schemas.xmlsoap.org/soap/http";
mySoapBinding.Style = SoapBindingStyle.Document;

OperationBinding addOperationBinding =
       CreateOperationBinding("Add",myDescription.TargetNamespace);
myBinding.Operations.Add(addOperationBinding);
myBinding.Extensions.Add(mySoapBinding);

// Add the Binding to the ServiceDescription.
myDescription.Bindings.Add(myBinding);
myDescription.Write("MyOutWsdl.wsdl");
' Obtain the ServiceDescription of existing Wsdl.
Dim myDescription As ServiceDescription = ServiceDescription.Read("MyWsdl_VB.wsdl")
' Remove the Binding from the Binding Collection of ServiceDescription.
Dim myBindingCollection As BindingCollection = myDescription.Bindings
myBindingCollection.Remove(myBindingCollection(0))

' Form a new Binding.
Dim myBinding As New Binding()
myBinding.Name = "Service1Soap"
Dim myXmlQualifiedName As New XmlQualifiedName("s0:Service1Soap")
myBinding.Type = myXmlQualifiedName

Dim mySoapBinding As New SoapBinding()
mySoapBinding.Transport = "http://schemas.xmlsoap.org/soap/http"
mySoapBinding.Style = SoapBindingStyle.Document

Dim addOperationBinding As OperationBinding = CreateOperationBinding("Add", _
                                             myDescription.TargetNamespace)
myBinding.Operations.Add(addOperationBinding)
myBinding.Extensions.Add(mySoapBinding)

' Add the Binding to the ServiceDescription.
myDescription.Bindings.Add(myBinding)
myDescription.Write("MyOutWsdl.wsdl")

Комментарии

Экземпляры этого класса можно создать с new помощью ключевого слова или статического Read метода, который анализирует WSDL-файл и назначает его значения соответствующим членам класса.

WSDL — это язык на основе XML для описания веб-служб XML. Класс ServiceDescription соответствует корневому элементу definitionsWSDL-файла. Дополнительные сведения о WSDL см. в спецификации WSDL .

Конструкторы

Имя Описание
ServiceDescription()

Инициализирует новый экземпляр класса ServiceDescription.

Поля

Имя Описание
Namespace

Пространство имен XML, в котором ServiceDescription определен класс ("http://schemas.xmlsoap.org/wsdl/")". Это поле является константой.

Свойства

Имя Описание
Bindings

Возвращает коллекцию Binding элементов, содержащихся в объекте ServiceDescription.

Documentation

Возвращает или задает текстовую документацию для экземпляра DocumentableItemобъекта .

(Унаследовано от DocumentableItem)
DocumentationElement

Возвращает или задает элемент документации для элемента DocumentableItem.

(Унаследовано от DocumentableItem)
ExtensibleAttributes

Возвращает или задает массив типа XmlAttribute , представляющий расширения атрибутов WSDL для соответствия требованиям взаимодействия веб-служб (WS-I) базовый профиль 1.1.

(Унаследовано от DocumentableItem)
Extensions

Возвращает коллекцию элементов расширяемости, содержащихся в элементе ServiceDescription.

Imports

Возвращает коллекцию Import элементов, содержащихся в объекте ServiceDescription.

Messages

Возвращает коллекцию Message элементов, содержащихся в объекте ServiceDescription.

Name

Возвращает или задает атрибут XML-имени тега descriptions , включающего файл языка описания веб-служб (WSDL).

Name

Возвращает или задает имя элемента.

(Унаследовано от NamedItem)
Namespaces

Возвращает или задает словарь префиксов пространства имен и пространств имен, используемых для сохранения префиксов пространства имен и пространств имен при ServiceDescription создании объекта.

(Унаследовано от DocumentableItem)
PortTypes

Возвращает коллекцию PortType элементов, содержащихся в объекте ServiceDescription.

RetrievalUrl

Возвращает или задает URL-адрес веб-службы XML, к которой ServiceDescription применяется экземпляр.

Schema

Возвращает схему, связанную с этим ServiceDescription.

Serializer

Получает XML-сериализатор, используемый для сериализации и десериализации между ServiceDescription объектом и документом языка описания веб-служб (WSDL).

ServiceDescriptions

ServiceDescriptionCollection Возвращает экземпляр, в котором ServiceDescription является член.

Services

Возвращает коллекцию Service экземпляров, содержащихся в объекте ServiceDescription.

TargetNamespace

Возвращает или задает XML-атрибут targetNamespacedescriptions тега, включающего файл языка описания веб-служб (WSDL).

Types

Возвращает или задает Types содержащийся элементом ServiceDescription.

ValidationWarnings

StringCollection Возвращает значение, содержащее предупреждения проверки, созданные во время вызова Read(Stream, Boolean), Read(TextReader, Boolean)Read(String, Boolean)или Read(XmlReader, Boolean) с заданным параметром validatetrue.

Методы

Имя Описание
CanRead(XmlReader)

Возвращает значение, указывающее, представляет ли XmlReader допустимый файл языка описания веб-служб (WSDL), который можно проанализировать.

Equals(Object)

Определяет, равен ли указанный объект текущему объекту.

(Унаследовано от Object)
GetHashCode()

Служит хэш-функцией по умолчанию.

(Унаследовано от Object)
GetType()

Возвращает Type текущего экземпляра.

(Унаследовано от Object)
MemberwiseClone()

Создает неглубокую копию текущей Object.

(Унаследовано от Object)
Read(Stream, Boolean)

Инициализирует экземпляр класса путем непосредственной ServiceDescription загрузки XML из экземпляра Stream .

Read(Stream)

Инициализирует экземпляр класса путем непосредственной ServiceDescription загрузки XML из экземпляра Stream .

Read(String, Boolean)

Инициализирует экземпляр объекта путем непосредственной ServiceDescription загрузки XML из указанного файла.

Read(String)

Инициализирует экземпляр объекта путем непосредственной ServiceDescription загрузки XML из указанного файла.

Read(TextReader, Boolean)

Инициализирует экземпляр класса путем непосредственной ServiceDescription загрузки XML из объекта TextReader.

Read(TextReader)

Инициализирует экземпляр класса путем непосредственной ServiceDescription загрузки XML из объекта TextReader.

Read(XmlReader, Boolean)

Инициализирует экземпляр класса путем непосредственной ServiceDescription загрузки XML из объекта XmlReader.

Read(XmlReader)

Инициализирует экземпляр класса путем непосредственной ServiceDescription загрузки XML из объекта XmlReader.

ToString()

Возвращает строку, представляющую текущий объект.

(Унаследовано от Object)
Write(Stream)

Записывает указанный ServiceDescriptionStreamобъект.

Write(String)

ServiceDescription Записывает файл в виде файла языка описания веб-служб (WSDL) в указанный путь.

Write(TextWriter)

ServiceDescription Записывает в файл TextWriterязыка описания веб-служб (WSDL).

Write(XmlWriter)

Записывает его в ServiceDescriptionXmlWriter файл языка описания веб-служб (WSDL).

Применяется к