Поделиться через


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-атрибут targetNamespace тега descriptions, содержащего файл WSDL.

Types

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

ValidationWarnings

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

Методы

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)

Записывает объект ServiceDescription в заданный объект Stream.

Write(String)

Записывает ServiceDescription как файл WSDL по указанному пути.

Write(TextWriter)

Записывает объект ServiceDescription как файл WSDL в объект TextWriter.

Write(XmlWriter)

Записывает объект ServiceDescription в объект XmlWriter как файл WSDL.

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