Classes gerenciadas SQLXML - objeto SqlXmlCommand

Aplica-se a:SQL ServerBanco de Dados SQL do Azure

Este é o construtor para o objeto SqlXmlCommand:

public SqlXmlCommand(string cnString)  

Onde cnString é a cadeia de ligação ADO ou OLEDB que identifica o servidor, a base de dados e a informação de login — por exemplo, Provider=SQLOLEDB; Server=(local); database=AdventureWorks; Integrated Security=SSPI".

Na cadeia de ligação, o Provider deve ser SQLOLEDB e não Data Provider deve ser incluído na cadeia do fornecedor).

Para um exemplo de trabalho, veja Executando Consultas SQL (SQLXML Managed Classes).

Methods

O objeto TheSqlXmlCommand suporta vários métodos, incluindo os seguintes métodos para executar um comando:

void ExecuteNonQuery()
Executa o comando, mas não retorna nada. Este método é útil se quiseres executar um comando que não seja de consulta (ou seja, um comando que não devolve nada). Um exemplo é executar um updategram ou um DiffGram que atualiza registos mas não retorna nada.

Stream ExecuteStream()
Devolve um novo objeto Stream. Este método é útil quando quer que os resultados da consulta sejam devolvidos num novo fluxo. Para um exemplo de trabalho, veja Executando Consultas SQL (SQLXML Managed Classes).

empty público ExecuteToStream(Stream outputStream)
Escreve os resultados da consulta num fluxo existente. Este método é útil quando tem um fluxo ao qual precisa de adicionar os resultados (por exemplo, para que os resultados da consulta sejam escritos no System.Web.HttpResponse.OutputStream). Para um exemplo de trabalho, veja Executando Consultas SQL (SQLXML Managed Classes).

XmlReader ExecuteXmlReader()
Devolve um objeto XmlReader. Pode usar este método para manipular dados diretamente no objeto XmlReader ou para ligar a arquitetura encadeável do System.Xml. Para mais informações, consulte a documentação do Microsoft .NET Framework. Para um exemplo de trabalho, veja Executando Consultas SQL Usando o Método ExecuteXMLReader.

O objeto TheSqlXmlCommand também suporta estes métodos adicionais:

SqlXmlParameter CreateParameter()
Cria um objeto SqlXmlParameter. Pode definir valores para os parâmetros de Nome e Valor deste objeto. Este método é útil se quiseres passar parâmetros para um comando. Para um exemplo de trabalho, veja Executando Consultas SQL (SQLXML Managed Classes).

void ClearParameters()
Limpa parâmetro(s) que foram criados para um dado objeto de comando. Este método é útil se quiseres executar múltiplas consultas no mesmo objeto de comando.

Propriedades

O objeto SqlXmlCommand também suporta estas propriedades:

ClientSideXml
Quando definido para Verdadeiro, especifica que a conversão do conjunto de linhas para XML deve ocorrer no cliente em vez do servidor. Esta propriedade é útil quando se quer mover a carga de desempenho para o nível intermédio. A propriedade também permite envolver os procedimentos armazenados existentes com XML FOR para obter saída XML.

SchemaPath
O nome do esquema de mapeamento juntamente com o caminho do diretório (por exemplo, C:\x\y\MySchema.xml). Esta propriedade é útil para especificar um esquema de mapeamento para consultas XPath. O caminho especificado pode ser absoluto ou relativo. Se o caminho for relativo, o caminho base especificado no Caminho Base é usado para resolver o caminho relativo. Se não for especificado o caminho base, o caminho relativo é relativo ao diretório atual. Para um exemplo de trabalho, veja Acesso à Funcionalidade SQLXML no Ambiente .NET.

XslPath
O nome do ficheiro XSL juntamente com o caminho do diretório. O caminho especificado pode ser absoluto ou relativo. Se o caminho for relativo, o caminho base especificado no Caminho Base é usado para resolver o caminho relativo. Se não for especificado o caminho base, o caminho relativo é relativo ao diretório atual. Para um exemplo de trabalho, consulte Aplicar uma Transformação XSL (SQLXML Managed Classes).

Caminho da Base
O caminho base (um caminho de diretório). Esta propriedade é útil para resolver um caminho relativo especificado para um ficheiro XSL (usando a propriedade XslPath), um ficheiro de esquema de mapeamento (usando a propriedade SchemaPath) ou uma referência de esquema externo num modelo XML (especificado usando o atributo mapeamento-schema ).

OutputEncoding
Especifica a codificação para o fluxo que é devolvido quando o comando é executado. Esta propriedade é útil para solicitar uma codificação específica para o fluxo que é devolvido. Algumas codificações mais usadas são UTF-8, ANSI e Unicode. UTF-8 é a codificação padrão.

Namespaces
Permite a execução de consultas XPath que utilizam namespaces. Para mais informações sobre consultas XPath com namespaces, consulte Executando Consultas XPath com Namespaces (SQLXML Managed Classes). Para um exemplo de trabalho, veja Executando Consultas XPath (SQLXML Managed Classes).

RootTag
Fornece o elemento raiz único para XML gerado por execução de comandos. Um documento XML válido requer uma única etiqueta ao nível da raiz. Se o comando executado gerar um fragmento XML (sem um único elemento de topo), pode especificar um elemento raiz para o XML que retorna. Para um exemplo de trabalho, consulte Aplicar uma Transformação XSL (SQLXML Managed Classes).

CommandText
O texto da ordem. Esta propriedade é usada para especificar o texto do comando que pretende executar. Para um exemplo de trabalho, veja Executando Consultas SQL (SQLXML Managed Classes).

CommandStream
O fluxo de comando. Esta propriedade é útil se quiser executar um comando a partir de um ficheiro (por exemplo, um modelo XML). Quando usas o CommandStream, apenas os valores "Template","UpdateGram" e "DiffGram"CommandType são suportados. Para um exemplo funcional, veja Executando Ficheiros de Modelo usando a propriedade CommandStream.

Tipo de comando
Identifica o tipo de comando. Esta propriedade é usada para especificar o tipo de comando que pretende executar. Os valores na tabela seguinte determinam o tipo do comando. Para um exemplo de trabalho, veja Acesso à Funcionalidade SQLXML no Ambiente .NET.

Valor	Description
SqlXmlCommandType.SQL	Executa um comando SQL (por exemplo, SELECT * FROM Employees FOR XML AUTO).
SqlXmlCommandType.XPath	Executa um comando XPath (por exemplo, Employees[@EmployeeID=1]).
SqlXmlCommandType.Template	Executa um modelo XML.
SqlXmlCommandType.TemplateFile	Executa um ficheiro modelo no caminho especificado.
SqlXmlCommandType.UpdateGram	Executa um updategram.
SqlXmlCommandType.Diffgram	Executa um DiffGram.

Ver também

SqlXmlParameter Object (SQLXML Managed Classes)
Objeto SqlXmlAdapter (Classes Geridas SQLXML)