ServiceDescription Classe

Definição

Fornece um meio de criar e formatar um ficheiro de documento válido da Web Services Description Language (WSDL), completo com namespaces, elementos e atributos apropriados, para descrever um serviço Web XML. Esta 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 seguinte 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")

Observações

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

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

Construtores

Name Description
ServiceDescription()

Inicializa uma nova instância da ServiceDescription classe.

Campos

Name Description
Namespace

O espaço de nomes XML onde a ServiceDescription classe está definida ("http://schemas.xmlsoap.org/wsdl/"). Este campo é constante.

Propriedades

Name Description
Bindings

Obtém a coleção de Binding elementos contida 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 um array de tipos XmlAttribute que representam extensões de atributos do WSDL para cumprir o Perfil Básico 1.1 da Interoperabilidade de Serviços Web (WS-I).

(Herdado de DocumentableItem)
Extensions

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

Imports

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

Messages

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

Name

Obtém ou define o atributo do nome XML da descriptions etiqueta que contém o ficheiro Web Services Description Language (WSDL).

Name

Obtém ou define o nome do item.

(Herdado de NamedItem)
Namespaces

Obtém ou define o dicionário dos prefixos e espaços de nomes usados para preservar prefixos e espaços de nomes quando um ServiceDescription objeto é construído.

(Herdado de DocumentableItem)
PortTypes

Obtém a coleção de PortType elementos contida 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 este ServiceDescription.

Serializer

Obtém o serializador XML usado para serializar e desserializar entre um ServiceDescription objeto e um documento da Web Services Description Language (WSDL).

ServiceDescriptions

Obtém a ServiceDescriptionCollection instância de que é ServiceDescription membro.

Services

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

TargetNamespace

Obtém ou define o atributo XML targetNamespace da descriptions etiqueta que envolve um ficheiro Web Services Description Language (WSDL).

Types

Obtém ou define o Types contido pelo ServiceDescription.

ValidationWarnings

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

Métodos

Name Description
CanRead(XmlReader)

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

Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetHashCode()

Serve como função de hash predefinida.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do atual Object.

(Herdado de Object)
Read(Stream, Boolean)

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

Read(Stream)

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

Read(String, Boolean)

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

Read(String)

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

Read(TextReader, Boolean)

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

Read(TextReader)

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

Read(XmlReader, Boolean)

Inicializa uma instância da ServiceDescription classe carregando diretamente o XML a partir de um XmlReaderarquivo .

Read(XmlReader)

Inicializa uma instância da ServiceDescription classe carregando diretamente o XML a partir de um XmlReaderarquivo .

ToString()

Devolve uma cadeia que representa o objeto atual.

(Herdado de Object)
Write(Stream)

Escreve o ServiceDescription para o especificado Stream.

Write(String)

Escreve o ServiceDescription ficheiro como uma Linguagem de Descrição de Serviços Web (WSDL) no caminho especificado.

Write(TextWriter)

Escreve o ServiceDescription ficheiro como uma Linguagem de Descrição de Serviços Web (WSDL) no TextWriterarquivo .

Write(XmlWriter)

Escreve o ServiceDescription para como XmlWriter um ficheiro de Linguagem de Descrição de Serviços Web (WSDL).

Aplica-se a