ServiceDescription Classe
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
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
- Herança
- 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 |
| 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 |
| 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 |
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). |