SqlCeRemoteDataAccess.Push Method (String, String)

Artículo
01/14/2011

Vuelve a transmitir los cambios de una tabla extraída de SQL Server Compact 3.5 de la que se ha realizado un seguimiento a la tabla de SQL Server de origen. Estos cambios se aplican uno por uno en el servidor, en transacciones independientes.

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

Sintaxis

'Declaración
Public Sub Push ( _
    localTableName As String, _
    oleDBConnectionString As String _
)

public void Push (
    string localTableName,
    string oleDBConnectionString
)

public:
void Push (
    String^ localTableName, 
    String^ oleDBConnectionString
)

public void Push (
    String localTableName, 
    String oleDBConnectionString
)

public function Push (
    localTableName : String, 
    oleDBConnectionString : String
)

Parámetros

localTableName
Nombre de la tabla SQL Server Compact 3.5 que recibirá los registros SQL Server extraídos. Si la tabla ya existe se produce un error.

oleDBConnectionString

Notas

Las aplicaciones llaman al método Push para volver a transmitir los cambios de una tabla extraída de SQL Server Compact 3.5, de la que se ha realizado un seguimiento, a una tabla de SQL Server. La aplicación debe haber creado la tabla local de SQL Server Compact 3.5 mediante una llamada al métodoPull con RdaTrackOption establecido en TrackingOn o TrackingOnWithIndexes.

oledbConnectionString especifica toda la información de conexión utilizada al realizar la conexión con SQL Server.

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.

Si se especificó errorTableName al llamar al método Pull, todos los errores detectados durante Push se registran en la tabla de errores. Para obtener más información sobre el funcionamiento de la tabla de errores, vea "RDA Conflict Detection and Resolution" (Detección y resolución de conflictos de acceso remoto a datos, RDA) en los libros en pantalla de SQL Server Compact 3.5.

Ejemplo

En el ejemplo siguiente se crea un objeto SqlCeRemoteDataAccess, se establecen varias propiedades y, a continuación, se llama al método Push.

' 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 Push Operation
    '
    rda = New SqlCeRemoteDataAccess( _
        "https://www.adventure-works.com/sqlmobile/sqlcesa35.dll", _
        "Data Source=MyDatabase.sdf")

    rda.InternetLogin = "MyLogin"
    rda.InternetPassword = "<password>"

    rda.Push("MyLocalTable", rdaOleDbConnectString, RdaBatchOption.BatchingOn)

    ' or, try this overload:
    '
    ' rda.Push("MyLocalTable", 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 Push Operation
    //
    rda = new SqlCeRemoteDataAccess(
        "https://www.adventure-works.com/sqlmobile/sqlcesa35.dll",
        "Data Source=MyDatabase.sdf");

    rda.InternetLogin = "MyLogin";
    rda.InternetPassword = "<password>";

    rda.Push("MyLocalTable", rdaOleDbConnectString, RdaBatchOption.BatchingOn);

    // or, try this overload:
    //
    // rda.Push("MyLocalTable", 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

Compartir a través de