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 соответствует корневому элементу definitions
WSDL-файла. Дополнительные сведения о языке 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) |
Инициализирует экземпляр класса ServiceDescription, напрямую загружая XML из экземпляра Stream. |
Read(Stream, Boolean) |
Инициализирует экземпляр класса ServiceDescription, напрямую загружая XML из экземпляра Stream. |
Read(String) |
Инициализирует экземпляр объекта ServiceDescription, напрямую загружая XML из заданного файла. |
Read(String, Boolean) |
Инициализирует экземпляр объекта ServiceDescription, напрямую загружая XML из заданного файла. |
Read(TextReader) |
Инициализирует экземпляр класса ServiceDescription, напрямую загружая XML из объекта TextReader. |
Read(TextReader, Boolean) |
Инициализирует экземпляр класса ServiceDescription, напрямую загружая XML из объекта TextReader. |
Read(XmlReader) |
Инициализирует экземпляр класса ServiceDescription, напрямую загружая XML из объекта XmlReader. |
Read(XmlReader, Boolean) |
Инициализирует экземпляр класса ServiceDescription, напрямую загружая XML из объекта XmlReader. |
ToString() |
Возвращает строку, представляющую текущий объект. (Унаследовано от Object) |
Write(Stream) |
Записывает объект ServiceDescription в заданный объект Stream. |
Write(String) |
Записывает ServiceDescription как файл WSDL по указанному пути. |
Write(TextWriter) |
Записывает объект ServiceDescription как файл WSDL в объект TextWriter. |
Write(XmlWriter) |
Записывает объект ServiceDescription в объект XmlWriter как файл WSDL. |