ServiceDescription Класс

Определение

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

System.Web.Services.Description

Сборка:

System.Web.Services.dll

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

public ref class ServiceDescription sealed : System::Web::Services::Description::NamedItem

[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 NamedItem

Public NotInheritable Class ServiceDescription
Inherits NamedItem

Наследование

Object

DocumentableItem

NamedItem

ServiceDescription

Атрибуты

XmlFormatExtensionPointAttribute

Примеры

В следующем примере показано создание экземпляра класса 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	Возвращает или задает имя элемента. (Унаследовано от 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.