SqlCeRemoteDataAccess.SubmitSql Method

Article
01/14/2011

Soumet les instructions SQL pour exécution sur une base de données dans SQL Server sur un serveur distant.

Espace de noms: System.Data.SqlServerCe
Assembly: System.Data.SqlServerCe (dans system.data.sqlserverce.dll)

Syntaxe

'Déclaration
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
)

Paramètres

sqlString
Toute instruction SQL qui ne retourne pas des lignes.

oleDBConnectionString
Chaîne de connexion OLE DB pour la base de données SQL Server distante.

Remarques

La propriété InternetUrl doit contenir l'URL de l'Agent serveur SQL Server Compact 3.5.

Les propriétés InternetLogin et InternetPassword doivent être spécifiées si l'Agent serveur SQL Server Compact 3.5 est configuré de manière à utiliser l'authentification de base ou l'authentification Windows intégrée.

Si l'authentification SQL Server est utilisée, l'ID d'utilisateur spécifié dans oledbConnectionString doit disposer de l'autorisation requise pour lire la table SQL Server.

Si l'authentification Windows est utilisée en définissant INTEGRATED SECURITY="SSPI" dans oledbConnectionString, l'utilisateur Internet doit avoir l'autorisation requise pour lire la table SQL Server. Ce qui suit identifie l'utilisateur Internet en fonction de la méthode d'authentification :

Lorsque le répertoire virtuel des services IIS ( Microsoft Internet Information Services) est configuré de manière à utiliser l'accès anonyme, l'utilisateur Internet utilise l'identité du Compte Invité Internet (IUSR_NomOrdinateur). Si vous configurez un autre compte d'utilisateur Windows en tant que Compte Invité Internet, l'utilisateur Internet utilise l'identité de ce compte.
Lorsque le répertoire virtuel IIS est configuré de manière à employer l'authentification de base, l'utilisateur Internet utilise l'identité du compte d'utilisateur Windows pour lequel le client a fourni le nom d'utilisateur Internet et le mot de passe correspondant.
Lorsque le répertoire virtuel IIS est configuré de manière à employer l'authentification intégrée de Windows, l'utilisateur Internet utilise l'identité du compte d'utilisateur Windows pour lequel le client a fourni le nom d'utilisateur Internet et le mot de passe correspondant.

Exemple

L'exemple suivant crée un objet SqlCeRemoteDataAccess, définit plusieurs propriétés, puis appelle la méthode 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();
}

Sécurité des threads

Tout membre statique public (Partagé dans Microsoft Visual Basic) de ce type sont thread-safe. Tous les membres de l'instance ne sont pas garantis comme sûrs.

Plateformes

Plateformes de développement

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
Informations sur la version
.NET Framework et NET Compact Framework
Pris en charge dans 3.5
.NET Framework
Pris en charge dans 3.0
.NET Compact Framework et .Net Framework
Pris en charge dans 2.0

Voir aussi

Référence

SqlCeRemoteDataAccess Class
SqlCeRemoteDataAccess Members
System.Data.SqlServerCe Namespace

Partager via