ServiceDescription Classe

Definição

Fornece um meio de criar e formatar um arquivo de documento WSDL (Linguagem de Descrição dos Serviços Web) válido, completo com namespaces, elementos e atributos apropriados para descrever um serviço Web XML. Essa classe não pode ser herdada.

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
Herança
ServiceDescription
Herança
ServiceDescription
Atributos

Exemplos

O exemplo a seguir mostra como criar uma instância da ServiceDescription classe.

// 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")

Comentários

Instâncias dessa classe podem ser criadas com a new palavra-chave ou o método estático Read , que analisa um arquivo WSDL e atribui seus valores a membros apropriados da classe.

O WSDL é uma linguagem baseada em XML para descrever os serviços Web XML. A ServiceDescription classe corresponde ao elemento raiz, definitionsde um arquivo WSDL. Para obter mais informações sobre o WSDL, consulte a especificação do WSDL .

Construtores

Nome Description
ServiceDescription()

Inicializa uma nova instância da classe ServiceDescription.

Campos

Nome Description
Namespace

O namespace XML no qual a ServiceDescription classe é definida ("http://schemas.xmlsoap.org/wsdl/"). Esse campo é constante.

Propriedades

Nome Description
Bindings

Obtém a coleção de Binding elementos contidos no ServiceDescription.

Documentation

Obtém ou define a documentação de texto para a instância do DocumentableItem.

(Herdado de DocumentableItem)
DocumentationElement

Obtém ou define o elemento de documentação do DocumentableItem.

(Herdado de DocumentableItem)
ExtensibleAttributes

Obtém ou define uma matriz de tipo XmlAttribute que representa extensões de atributo do WSDL para estar em conformidade com o Perfil Básico 1.1 de Interoperabilidade de Serviços Web (WS-I).

(Herdado de DocumentableItem)
Extensions

Obtém a coleção de elementos de extensibilidade contidos no ServiceDescription.

Imports

Obtém a coleção de Import elementos contidos no ServiceDescription.

Messages

Obtém a coleção de Message elementos contidos no ServiceDescription.

Name

Obtém ou define o atributo de nome XML da descriptions marca que inclui o arquivo WSDL (Linguagem de Descrição dos Serviços Web).

Name

Obtém ou define o nome do item.

(Herdado de NamedItem)
Namespaces

Obtém ou define o dicionário de prefixos de namespace e namespaces usados para preservar prefixos de namespace e namespaces quando um ServiceDescription objeto é construído.

(Herdado de DocumentableItem)
PortTypes

Obtém a coleção de PortType elementos contidos no ServiceDescription.

RetrievalUrl

Obtém ou define a URL do serviço Web XML ao qual a ServiceDescription instância se aplica.

Schema

Obtém o esquema associado a isso ServiceDescription.

Serializer

Obtém o serializador XML usado para serializar e desserializar entre um ServiceDescription objeto e um documento WSDL (Linguagem de Descrição dos Serviços Web).

ServiceDescriptions

Obtém a ServiceDescriptionCollection instância da qual o ServiceDescription membro é.

Services

Obtém a coleção de Service instâncias contidas no ServiceDescription.

TargetNamespace

Obtém ou define o atributo XML targetNamespace da descriptions marca que inclui um arquivo WSDL (Linguagem de Descrição dos Serviços Web).

Types

Obtém ou define o Types contido pelo ServiceDescription.

ValidationWarnings

Obtém um StringCollection que contém quaisquer avisos de validação que foram gerados durante uma chamada para Read(Stream, Boolean), Read(TextReader, Boolean)ou Read(XmlReader, Boolean)Read(String, Boolean)com o validate parâmetro definido como true.

Métodos

Nome Description
CanRead(XmlReader)

Obtém um valor que indica se um XmlReader arquivo WSDL (Linguagem de Descrição dos Serviços Web) válido pode ser analisado.

Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetHashCode()

Serve como a função hash predefinida.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do Objectatual.

(Herdado de Object)
Read(Stream, Boolean)

Inicializa uma instância da ServiceDescription classe carregando diretamente o XML de uma Stream instância.

Read(Stream)

Inicializa uma instância da ServiceDescription classe carregando diretamente o XML de uma Stream instância.

Read(String, Boolean)

Inicializa uma instância de um ServiceDescription objeto carregando diretamente o XML do arquivo especificado.

Read(String)

Inicializa uma instância de um ServiceDescription objeto carregando diretamente o XML do arquivo especificado.

Read(TextReader, Boolean)

Inicializa uma instância da ServiceDescription classe carregando diretamente o XML de um TextReader.

Read(TextReader)

Inicializa uma instância da ServiceDescription classe carregando diretamente o XML de um TextReader.

Read(XmlReader, Boolean)

Inicializa uma instância da ServiceDescription classe carregando diretamente o XML de um XmlReader.

Read(XmlReader)

Inicializa uma instância da ServiceDescription classe carregando diretamente o XML de um XmlReader.

ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.

(Herdado de Object)
Write(Stream)

Grava o ServiceDescription arquivo no especificado Stream.

Write(String)

Grava o ServiceDescription arquivo WSDL (Linguagem de Descrição dos Serviços Web) no caminho especificado.

Write(TextWriter)

Grava o ServiceDescription arquivo WSDL (Linguagem de Descrição dos Serviços Web) como um .TextWriter

Write(XmlWriter)

Grava o ServiceDescriptionXmlWriter arquivo WSDL (Linguagem de Descrição dos Serviços Web).

Aplica-se a