ServiceDescription Classe
Definição
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 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
- Herança
- 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 |
| 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 |
| 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 |
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). |