SqlCeRemoteDataAccess.SubmitSql Method

Envía instrucciones SQL para que se ejecuten en una base de datos SQL Server en un servidor remoto.

Espacio de nombres: System.Data.SqlServerCe
Ensamblado: System.Data.SqlServerCe (en system.data.sqlserverce.dll)

Sintaxis

'Declaración
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
  Cualquier instrucción SQL que no devuelve filas.

• oleDBConnectionString
  Cadena de conexión OLE DB para la base de datos remota de SQL Server.

Notas

La propiedad InternetUrl debe contener la dirección URL del agente del servidor SQL Server Compact 3.5.

Las propiedades InternetLogin y InternetPassword se deben especificar si el agente del servidor SQL Server Compact 3.5 se ha configurado de modo que utilice la autenticación básica o integrada de Windows.

Si se utiliza la autenticación de SQL Server, el identificador de usuario especificado en oledbConnectionString debe estar autorizado para leer la tabla SQL Server.

Si se utiliza la autenticación de Windows mediante el establecimiento de INTEGRATED SECURITY="SSPI" en oledbConnectionString, el usuario de Internet debe estar autorizado para leer la tabla SQL Server. A continuación, se identifica el usuario de Internet en función del método de autenticación:

• Si el directorio virtual de Microsoft Internet Information Services (IIS) está configurado para el uso de un acceso anónimo, el usuario de Internet utiliza la identidad de la cuenta de invitado para Internet (IUSR_nombreDeEquipo). Si configura otra cuenta de usuario de Windows como cuenta de invitado para Internet, el usuario de Internet utiliza la identidad de dicha cuenta.

• Si el directorio virtual de IIS se configura de modo que utilice la autenticación básica, el usuario de Internet utiliza la identidad de la cuenta de usuario de Windows para la que el cliente ha suministrado un nombre de usuario y una contraseña de Internet.

• Si el directorio virtual de IIS se configura de modo que utilice la autenticación integrada de Windows, el usuario de Internet utiliza la identidad de la cuenta de usuario de Windows para la que el cliente ha suministrado un nombre de usuario y una contraseña de Internet.

Ejemplo

En el ejemplo siguiente se crea un objeto SqlCeRemoteDataAccess, se establecen varias propiedades y, a continuación, se llama al 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();
}

Seguridad para subprocesos

Todos los miembros (Compartidos en Microsoft Visual Basic) de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancia sean seguros para subprocesos.

Plataformas

Plataformas de desarrollo

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
Información de la versión
.NET Framework y NET Compact Framework
Se admite en 3.5
.NET Framework
Se admite en 3.0
.NET Compact Framework y .Net Framework
Se admite en 2.0

Vea también

Referencia

SqlCeRemoteDataAccess Class
SqlCeRemoteDataAccess Members
System.Data.SqlServerCe Namespace