ServiceDescription Classe

Referência

Definição

Namespace:: System.Web.Services.Description

Assembly:: System.Web.Services.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Fornece uma maneira de criar e formatar um arquivo de documento de linguagem WSDL 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: Object

DocumentableItem
ServiceDescription

Herança: Object

DocumentableItem

NamedItem
ServiceDescription

Atributos: XmlFormatExtensionPointAttribute

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 serviços Web XML. A ServiceDescription classe corresponde ao elemento raiz, definitionsde um arquivo WSDL. Para obter mais informações sobre WSDL, confira a especificação WSDL.

Construtores

ServiceDescription()

Inicializa uma nova instância da classe ServiceDescription.

Campos

Namespace

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

Propriedades

Bindings	Obtém a coleção de elementos Binding 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 para o DocumentableItem. (Herdado de DocumentableItem)
ExtensibleAttributes	Obtém ou define uma matriz do tipo XmlAttribute que representa extensões de atributo do WSDL para estarem em conformidade com o Perfil Básico 1.1 WS-I (Interoperabilidade de Serviços Web). (Herdado de DocumentableItem)
Extensions	Obtém a coleção de elementos de extensibilidade contidos no ServiceDescription.
Imports	Obtém a coleção de elementos Import contidos no ServiceDescription.
Messages	Obtém a coleção de elementos Message contidos no ServiceDescription.
Name	Obtém ou define o atributo de nome XML da marca `descriptions` colocando entre aspas o arquivo de linguagem WSDL.
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 os namespaces usados para preservar prefixos de namespace e namespaces quando um objeto ServiceDescription é construído. (Herdado de DocumentableItem)
PortTypes	Obtém a coleção de elementos PortType contidos no ServiceDescription.
RetrievalUrl	Obtém ou define a URL do serviço Web XML ao qual a instância de ServiceDescription se aplica.
Schema	Obtém o esquema associado a este ServiceDescription.
Serializer	Obtém o serializador XML usado para serializar e desserializar entre um objeto ServiceDescription e um documento de linguagem WSDL.
ServiceDescriptions	Obtém a instância de ServiceDescriptionCollection da qual o ServiceDescription é membro.
Services	Obtém a coleção de instâncias de Service contidas no ServiceDescription.
TargetNamespace	Obtém ou define o atributo XML `targetNamespace` da marca `descriptions` fechando um arquivo de linguagem WSDL.
Types	Obtém ou define o Types contido pelo ServiceDescription.
ValidationWarnings	Obtém um StringCollection que contém os avisos de validação gerados durante uma chamada para Read(Stream, Boolean), Read(TextReader, Boolean), Read(String, Boolean) ou Read(XmlReader, Boolean) com o parâmetro `validate` definido como `true`.

Métodos

CanRead(XmlReader)	Obtém um valor que indica se um XmlReader representa um arquivo de linguagem WSDL válido que pode ser analisado.
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
Read(Stream)	Inicializa uma instância da classe ServiceDescription ao carregar diretamente o XML de uma instância do Stream.
Read(Stream, Boolean)	Inicializa uma instância da classe ServiceDescription ao carregar diretamente o XML de uma instância do Stream.
Read(String)	Inicializa uma instância de um objeto ServiceDescription carregando diretamente o XML do arquivo especificado.
Read(String, Boolean)	Inicializa uma instância de um objeto ServiceDescription carregando diretamente o XML do arquivo especificado.
Read(TextReader)	Inicializa uma instância da classe ServiceDescription ao carregar diretamente o XML de um TextReader.
Read(TextReader, Boolean)	Inicializa uma instância da classe ServiceDescription ao carregar diretamente o XML de um TextReader.
Read(XmlReader)	Inicializa uma instância da classe ServiceDescription ao carregar diretamente o XML de um XmlReader.
Read(XmlReader, Boolean)	Inicializa uma instância da classe ServiceDescription ao carregar 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 no Stream especificado.
Write(String)	Grava o ServiceDescription como um arquivo de linguagem WSDL no caminho especificado.
Write(TextWriter)	Grava o ServiceDescription como um arquivo de linguagem WSDL no TextWriter.
Write(XmlWriter)	Grava o ServiceDescription no XmlWriter como um arquivo de linguagem WSDL.

Aplica-se a