SqlCeRemoteDataAccess.SubmitSql Method

Artigo
01/14/2011

Envia instruções SQL para execução em um banco de dados no SQL Server em um servidor remoto.

Namespace: System.Data.SqlServerCe
Assembly: System.Data.SqlServerCe (em system.data.sqlserverce.dll)

Sintaxe

'Declaração
Public Sub SubmitSql ( _
    sqlString As String, _
    oleDBConnectionString As String _
)

public void SubmitSql (
    string sqlString,
    string oleDBConnectionString
)

public:
void SubmitSql (
    String^ sqlString, 
    String^ oleDBConnectionString
)

public void SubmitSql (
    String sqlString, 
    String oleDBConnectionString
)

public function SubmitSql (
    sqlString : String, 
    oleDBConnectionString : String
)

Parâmetros

sqlString
Qualquer instrução SQL que não retorna linhas.

oleDBConnectionString
A cadeia de conexão OLE DB para o banco de dados do SQL Server remoto.

Comentários

A propriedade InternetUrl deve conter a URL do Agente de Servidor do SQL Server Compact 3.5.

As propriedades InternetLogin e InternetPassword deverão ser especificadas se o Agente de Servidor do SQL Server Compact 3.5 estiver configurado para usar a autenticação Básica ou Integrada do Windows.

Se a Autenticação do SQL Server for usada, a identificação do usuário especificada em oledbConnectionString deve ter a autoridade para ler a tabela do SQL Server.

Se a Autenticação do Windows for usada configurando INTEGRATED SECURITY="SSPI" em oledbConnectionString, o usuário da Internet deverá ter a autoridade para ler a tabela do SQL Server. O usuário da Internet é identificado com base no método de autenticação pelo seguinte:

Quando o diretório virtual dos Serviços de Informações da Internet da Microsoft (IIS) estiver configurado para usar o acesso anônimo, o usuário da Internet será executado com a identidade da Conta Convidado da Internet (IUSR_nomedocomputador). Se você configurar uma outra conta de usuário do Windows como Conta Convidado da Internet, o usuário da Internet será executado com a identidade dessa conta.
Quando o diretório virtual dos IIS estiver configurado para usar a autenticação Básica, o usuário da Internet será executado com a identidade da conta de usuário do Windows cujo nome de usuário da Internet e senha o cliente forneceu.
Quando o diretório virtual dos IIS estiver configurado para usar a autenticação Integrada do Windows, o usuário da Internet será executado com a identidade da conta de usuário do Windows cujo nome de usuário da Internet e senha o cliente forneceu.

Exemplo

O exemplo a seguir cria um objeto SqlCeRemoteDataAccess, define várias propriedades e chama o método SubmitSql.

' Connection String to the SQL Server
'
Dim rdaOleDbConnectString As String = "Data Source=MySqlServer;Initial Catalog=AdventureWorks; " & _
    "User Id=username;Password = <password>"

' Initialize RDA Object
'
Dim rda As SqlCeRemoteDataAccess = Nothing

Try
    ' Try the SubmitSql Operation
    '
    rda = New SqlCeRemoteDataAccess()

    rda.InternetLogin = "MyLogin"
    rda.InternetPassword = "<password>"
    rda.InternetUrl = "https://www.adventure-works.com/sqlmobile/sqlcesa35.dll"
    rda.LocalConnectionString = "Data Source=MyDatabase.sdf"

    rda.SubmitSql("CREATE TABLE MyRemoteTable (colA int)", rdaOleDbConnectString)
Catch
    ' Handle errors here
    '
Finally
    'Dispose of the RDA object
    '
    rda.Dispose()
End Try

// Connection String to the SQL Server
//
string rdaOleDbConnectString = "Data Source=MySqlServer;Initial Catalog=AdventureWorks; " +
    "User Id=username;Password = <password>";

// Initialize RDA Object
//
SqlCeRemoteDataAccess rda = null;

try
{
    // Try the SubmitSql Operation
    //
    rda = new SqlCeRemoteDataAccess();

    rda.InternetLogin = "MyLogin";
    rda.InternetPassword = "<password>";
    rda.InternetUrl = "https://www.adventure-works.com/sqlmobile/sqlcesa35.dll";
    rda.LocalConnectionString = "Data Source=MyDatabase.sdf";

    rda.SubmitSql("CREATE TABLE MyRemoteTable (colA int)", rdaOleDbConnectString);
}
catch (SqlCeException)
{
    // Handle errors here
    //
}
finally
{
    //Dispose of the RDA object
    //
    rda.Dispose();
}

Segurança de thread

Quaisquer membros estáticos públicos (compartilhados no Microsoft Visual Basic) desse tipo são thread safe. Não há garantia de que qualquer membro de instância seja thread safe.

Plataformas

Plataformas de desenvolvimento

Windows Vista, Windows Mobile 5.0, Windows XP Professional with Service Pack 2 (SP2), Windows Server 2003, Windows Mobile 2003 for Pocket PC, Windows CE 5.0
Informações de versão
.NET Framework e NET Compact Framework
Com suporte no 3.5
.NET Framework
Com suporte no 3.0
.NET Compact Framework e .Net Framework
Com suporte no 2.0

Consulte também

Referência

SqlCeRemoteDataAccess Class
SqlCeRemoteDataAccess Members
System.Data.SqlServerCe Namespace

Compartilhar via