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 класса.
// 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-имени тега |
| 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-атрибут |
| Types |
Возвращает или задает Types содержащийся элементом ServiceDescription. |
| ValidationWarnings |
StringCollection Возвращает значение, содержащее предупреждения проверки, созданные во время вызова Read(Stream, Boolean), Read(TextReader, Boolean)Read(String, Boolean)или Read(XmlReader, Boolean) с заданным параметром |
Методы
| Имя | Описание |
|---|---|
| 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). |