Partilhar via


ServiceDescription Classe

Definição

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
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 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