ServiceDescription Класс

Определение

Предоставляет возможности для создания и форматирования допустимых файлов документов WSDL, а также соответствующие пространства имен, элемент и атрибуты для описания веб-служб XML.Provides a means of creating and formatting a valid Web Services Description Language (WSDL) document file, complete with appropriate namespaces, elements, and attributes, for describing an XML Web service. Этот класс не наследуется.This class cannot be inherited.

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
type ServiceDescription = class
    inherit NamedItem
Public NotInheritable Class ServiceDescription
Inherits NamedItem
Наследование
ServiceDescription
Атрибуты

Примеры

В следующем примере показано создание экземпляра класса ServiceDescription.The following example shows how to create an instance of the ServiceDescription class.

// 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-файл и присваивает его значения соответствующим членам класса.Instances of this class can be created with either the new keyword or the static Read method, which parses a WSDL file and assigns its values to appropriate members of the class.

WSDL — это язык на основе XML для описания веб-служб XML.WSDL is an XML-based language for describing XML Web services. Класс соответствует корневому definitionsэлементу WSDL-файла. ServiceDescriptionThe ServiceDescription class corresponds to the root element, definitions, of a WSDL file. Дополнительные сведения о языке WSDL см. в спецификации WSDL.For more information about WSDL, see the WSDL specification.

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

ServiceDescription()

Инициализирует новый экземпляр класса ServiceDescription.Initializes a new instance of the ServiceDescription class.

Поля

Namespace

Пространство имен XML, в котором определен класс ServiceDescription ("http://schemas.xmlsoap.org/wsdl/").The XML namespace in which the ServiceDescription class is defined ("http://schemas.xmlsoap.org/wsdl/"). Это поле является константой.This field is constant.

Свойства

Bindings

Возвращает коллекцию элементов Binding, содержащихся в коллекции ServiceDescription.Gets the collection of Binding elements contained in the ServiceDescription.

Documentation

Возвращает или устанавливает текст документации для экземпляра DocumentableItem.Gets or sets the text documentation for the instance of the DocumentableItem.

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

Получает или задает элемент документации для объекта DocumentableItem.Gets or sets the documentation element for the DocumentableItem.

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

Получает или задает массив типа XmlAttribute, представляющий расширения атрибутов WSDL для обеспечения соответствия базовому профилю WS-I версии 1.1.Gets or sets an array of type XmlAttribute that represents attribute extensions of WSDL to comply with Web Services Interoperability (WS-I) Basic Profile 1.1.

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

Возвращает коллекцию элементов расширения среды, содержащихся в ServiceDescription.Gets the collection of extensibility elements contained in the ServiceDescription.

Imports

Возвращает коллекцию элементов Import, содержащихся в коллекции ServiceDescription.Gets the collection of Import elements contained in the ServiceDescription.

Messages

Возвращает коллекцию элементов Message, содержащихся в коллекции ServiceDescription.Gets the collection of Message elements contained in the ServiceDescription.

Name

Возвращает или устанавливает XML-атрибут имени тега descriptions, содержащего WSDL-файл.Gets or sets the XML name attribute of the descriptions tag enclosing the Web Services Description Language (WSDL) file.

Namespaces

Получает или задает словарь префиксов пространств имен и пространства имен, используемые для сохранения префиксов пространств имен при конструировании объекта ServiceDescription.Gets or sets the dictionary of namespace prefixes and namespaces used to preserve namespace prefixes and namespaces when a ServiceDescription object is constructed.

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

Возвращает коллекцию элементов PortType, содержащихся в коллекции ServiceDescription.Gets the collection of PortType elements contained in the ServiceDescription.

RetrievalUrl

Возвращает или устанавливает URL-адрес веб-службы XML, к которой применяется экземпляр ServiceDescription.Gets or sets the URL of the XML Web service to which the ServiceDescription instance applies.

Schema

Возвращает схему, сопоставленную этому объекту ServiceDescription.Gets the schema associated with this ServiceDescription.

Serializer

Возвращает XML-сериализатор, используемый для сериализации и десериализации между объектом ServiceDescription и документом WSDL.Gets the XML serializer used to serialize and deserialize between a ServiceDescription object and a Web Services Description Language (WSDL) document.

ServiceDescriptions

Возвращает экземпляр ServiceDescriptionCollection, членом которого является ServiceDescription.Gets the ServiceDescriptionCollection instance of which the ServiceDescription is a member.

Services

Возвращает коллекцию экземпляров Service, содержащихся в ServiceDescription.Gets the collection of Service instances contained in the ServiceDescription.

TargetNamespace

Возвращает или устанавливает XML-атрибут targetNamespace тега descriptions, содержащего файл WSDL.Gets or sets the XML targetNamespace attribute of the descriptions tag enclosing a Web Services Description Language (WSDL) file.

Types

Возвращает или задает Types, содержащийся в ServiceDescription.Gets or sets the Types contained by the ServiceDescription.

ValidationWarnings

Возвращает коллекцию StringCollection, содержащую любые предупреждения проверки, которые были созданы во время вызова методов Read(Stream, Boolean), Read(TextReader, Boolean), Read(String, Boolean) или Read(XmlReader, Boolean) при установленном для параметра validate значении true.Gets a StringCollection that contains any validation warnings that were generated during a call to Read(Stream, Boolean), Read(TextReader, Boolean), Read(String, Boolean), or Read(XmlReader, Boolean) with the validate parameter set to true.

Методы

CanRead(XmlReader)

Возвращает значение, указывающее, предоставляет ли XmlReader допустимый файл WSDL, доступный для анализа.Gets a value that indicates whether an XmlReader represents a valid Web Services Description Language (WSDL) file that can be parsed.

Equals(Object)

Определяет, равен ли указанный объект текущему объекту.Determines whether the specified object is equal to the current object.

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

Служит в качестве хэш-функции по умолчанию.Serves as the default hash function.

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

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

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

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

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

Инициализирует экземпляр класса ServiceDescription, напрямую загружая XML из экземпляра Stream.Initializes an instance of the ServiceDescription class by directly loading the XML from a Stream instance.

Read(Stream, Boolean)

Инициализирует экземпляр класса ServiceDescription, напрямую загружая XML из экземпляра Stream.Initializes an instance of the ServiceDescription class by directly loading the XML from a Stream instance.

Read(String)

Инициализирует экземпляр объекта ServiceDescription, напрямую загружая XML из заданного файла.Initializes an instance of a ServiceDescription object by directly loading the XML from the specified file.

Read(String, Boolean)

Инициализирует экземпляр объекта ServiceDescription, напрямую загружая XML из заданного файла.Initializes an instance of a ServiceDescription object by directly loading the XML from the specified file.

Read(TextReader)

Инициализирует экземпляр класса ServiceDescription, напрямую загружая XML из объекта TextReader.Initializes an instance of the ServiceDescription class by directly loading the XML from a TextReader.

Read(TextReader, Boolean)

Инициализирует экземпляр класса ServiceDescription, напрямую загружая XML из объекта TextReader.Initializes an instance of the ServiceDescription class by directly loading the XML from a TextReader.

Read(XmlReader)

Инициализирует экземпляр класса ServiceDescription, напрямую загружая XML из объекта XmlReader.Initializes an instance of the ServiceDescription class by directly loading the XML from an XmlReader.

Read(XmlReader, Boolean)

Инициализирует экземпляр класса ServiceDescription, напрямую загружая XML из объекта XmlReader.Initializes an instance of the ServiceDescription class by directly loading the XML from an XmlReader.

ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

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

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

Write(String)

Записывает ServiceDescription как файл WSDL по указанному пути.Writes out the ServiceDescription as a Web Services Description Language (WSDL) file to the specified path.

Write(TextWriter)

Записывает объект ServiceDescription как файл WSDL в объект TextWriter.Writes out the ServiceDescription as a Web Services Description Language (WSDL) file to the TextWriter.

Write(XmlWriter)

Записывает объект ServiceDescription в объект XmlWriter как файл WSDL.Writes out the ServiceDescription to the XmlWriter as a Web Services Description Language (WSDL) file.

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