SqlCeRemoteDataAccess.Pullとは? わかりやすく解説

SqlCeRemoteDataAccess.Pull メソッド (String, String, String, RdaTrackOption)

リモートの Microsoft SQL Server データベースからデータをダウンロードし、ローカルの Microsoft SQL Server Mobile データベース内の単一のテーブルに格納します。

名前空間: System.Data.SqlServerCe
アセンブリ: System.Data.SqlServerCe (system.data.sqlserverce.dll 内)
構文構文

Public Sub Pull ( _
    localTableName As String, _
    sqlSelectString As String, _
    oleDBConnectionString As String, _
    trackOption As RdaTrackOption _
)
Dim instance As SqlCeRemoteDataAccess
Dim localTableName As String
Dim sqlSelectString As String
Dim oleDBConnectionString As String
Dim trackOption As RdaTrackOption

instance.Pull(localTableName, sqlSelectString, oleDBConnectionString, trackOption)
public void Pull (
    string localTableName,
    string sqlSelectString,
    string oleDBConnectionString,
    RdaTrackOption trackOption
)
public:
void Pull (
    String^ localTableName, 
    String^ sqlSelectString, 
    String^ oleDBConnectionString, 
    RdaTrackOption trackOption
)
public void Pull (
    String localTableName, 
    String sqlSelectString, 
    String oleDBConnectionString, 
    RdaTrackOption trackOption
)
public function Pull (
    localTableName : String, 
    sqlSelectString : String, 
    oleDBConnectionString : String, 
    trackOption : RdaTrackOption
)

パラメータ

localTableName

取得された SQL Server のレコードを受け取る SQL Server Mobile のテーブルの名前。テーブルが既に存在する場合は、エラーが発生します。

sqlSelectString

SQL Server データベースから取り出して SQL Server Mobile データベースに格納するテーブル、列、レコードを指定する任意の有効な Transact-SQL ステートメント。これには SELECT ステートメントやストアド プロシージャが含まれます。

oleDBConnectionString
trackOption

プルされたテーブルに対する変更を SQL Server Mobile が追跡するかどうか、また、プルされたテーブルに存在するインデックスを PRIMARY KEY 制約と共にデバイスに格納するかどうかを示すオプション。

解説解説

SQL Server Mobile サーバー エージェントを含む仮想ディレクトリが基本認証または統合 Windows 認証を使用するように構成されている場合は、InternetLogin プロパティと InternetPassword プロパティを指定する必要があります。SQL Server のテーブルからプルするデータは、sqlSelectString によって制御します。結果のレコードセットが timestamp など、サポートされていないデータ型を含んでいる場合、エラーが発生します。sqlSelectString で WHERE 句を指定して、どのレコードを取得するかを制御できます。たとえば、SELECT * FROM Customers WHERE State='CA' は、カリフォルニア州在住の顧客だけを返します。sqlSelectString は、行を返すストアド プロシージャまたはビューもサポートしています。TrackingOff オプションを使用している場合は、複数のテーブルから選択した列を 1 つのテーブルにプルすることもできます。

SQL Server 認証を使用する場合は、OLEDBConnectionString で指定したユーザー ID に SQL Server テーブルの読み取り権限が付与されている必要があります。

OLEDBConnectionString に INTEGRATED SECURITY="SSPI" を設定して Windows 認証を使用する場合は、インターネット ユーザーに SQL Server テーブルの読み取り権限が付与されている必要があります。インターネット ユーザーは、次のように認証方法に基づいて識別されます。

データ アクセスおよび制約事項の詳細については、SQL Server Mobile Books Online の「サポートされているデータ型およびデータ型マッピング」および「RDA の制限事項」を参照してください。

使用例使用例

SqlCeRemoteDataAccess オブジェクトを作成し、いくつかのプロパティを設定して、Pull メソッドを呼び出す例を次に示します。

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

    rda.Pull("Employees", "SELECT
 * FROM DimEmployee", rdaOleDbConnectString, _
        RdaTrackOption.TrackingOnWithIndexes, "ErrorTable")

    ' or, try one of these overloads:
    ' rda.Pull("Employees", "SELECT * FROM DimEmployee",
 rdaOleDbConnectString, _
    '     RdaTrackOption.TrackingOnWithIndexes)
    '
    ' rda.Pull("Employees", "SELECT * FROM DimEmployee",
 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 Pull Operation
    //
    rda = new SqlCeRemoteDataAccess(
        "http://www.adventure-works.com/sqlmobile/sqlcesa30.dll"
,
        "MyLogin",
        "<password>",
        "Data Source=MyDatabase.sdf");

    rda.Pull("Employees", "SELECT * FROM DimEmployee", rdaOleDbConnectString
,
        RdaTrackOption.TrackingOnWithIndexes, "ErrorTable");

    // or, try one of these overloads:
    //
    // rda.Pull("Employees", "SELECT * FROM DimEmployee",
 rdaOleDbConnectString,
    //     RdaTrackOption.TrackingOnWithIndexes);
    //
    // rda.Pull("Employees", "SELECT * FROM DimEmployee",
 rdaOleDbConnectString);
}
catch (SqlCeException)
{
    // Handle errors here
    //
}
finally
{
    // Dispose of the RDA object
    //
    rda.Dispose();
}
.NET Framework のセキュリティ.NET Framework のセキュリティ
プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照
関連項目
SqlCeRemoteDataAccess クラス
SqlCeRemoteDataAccess メンバ
System.Data.SqlServerCe 名前空間

SqlCeRemoteDataAccess.Pull メソッド (String, String, String, RdaTrackOption, String)

リモートの Microsoft SQL Server データベースからデータをダウンロードし、ローカルの Microsoft SQL Server Mobile データベース内の単一のテーブルに格納します。

名前空間: System.Data.SqlServerCe
アセンブリ: System.Data.SqlServerCe (system.data.sqlserverce.dll 内)
構文構文

Public Sub Pull ( _
    localTableName As String, _
    sqlSelectString As String, _
    oleDBConnectionString As String, _
    trackOption As RdaTrackOption, _
    errorTable As String _
)
Dim instance As SqlCeRemoteDataAccess
Dim localTableName As String
Dim sqlSelectString As String
Dim oleDBConnectionString As String
Dim trackOption As RdaTrackOption
Dim errorTable As String

instance.Pull(localTableName, sqlSelectString, oleDBConnectionString, trackOption,
 errorTable)
public void Pull (
    string localTableName,
    string sqlSelectString,
    string oleDBConnectionString,
    RdaTrackOption trackOption,
    string errorTable
)
public:
void Pull (
    String^ localTableName, 
    String^ sqlSelectString, 
    String^ oleDBConnectionString, 
    RdaTrackOption trackOption, 
    String^ errorTable
)
public void Pull (
    String localTableName, 
    String sqlSelectString, 
    String oleDBConnectionString, 
    RdaTrackOption trackOption, 
    String errorTable
)
public function Pull (
    localTableName : String, 
    sqlSelectString : String, 
    oleDBConnectionString : String, 
    trackOption : RdaTrackOption, 
    errorTable : String
)

パラメータ

localTableName

取得された SQL Server のレコードを受け取る SQL Server Mobile のテーブルの名前。テーブルが既に存在する場合は、エラーが発生します。

sqlSelectString

SQL Server データベースから取り出して SQL Server Mobile データベースに格納するテーブル、列、レコードを指定する任意の有効な Transact-SQL ステートメント。これには SELECT ステートメントやストアド プロシージャが含まれます。

oleDBConnectionString
trackOption

プルされたテーブルに対する変更を SQL Server Mobile が追跡するかどうか、また、プルされたテーブルに存在するインデックスを PRIMARY KEY 制約と共にデバイスに格納するかどうかを示すオプション。

errorTable

ローカル エラー テーブルの名前。このテーブルは、後に Push メソッドを呼び出して変更を SQL Server に送り返すときにエラーが発生した場合に作成されます。このオプションは、RdaTrackOption 値が TrackingOn または TrackingOnWithIndexes の場合にだけ、指定できます。

解説解説

SQL Server Mobile サーバー エージェントを含む仮想ディレクトリが基本認証または統合 Windows 認証を使用するように構成されている場合は、InternetLogin プロパティと InternetPassword プロパティを指定する必要があります。SQL Server のテーブルからプルするデータは、sqlSelectString によって制御します。結果のレコードセットが timestamp など、サポートされていないデータ型を含んでいる場合、エラーが発生します。sqlSelectString で WHERE 句を指定して、どのレコードを取得するかを制御できます。たとえば、SELECT * FROM Customers WHERE State='CA' は、カリフォルニア州在住の顧客だけを返します。sqlSelectString は、行を返すストアド プロシージャまたはビューもサポートしています。TrackingOff オプションを使用している場合は、複数のテーブルから選択した列を 1 つのテーブルにプルすることもできます。

SQL Server 認証を使用する場合は、OLEDBConnectionString で指定したユーザー ID に SQL Server テーブルの読み取り権限が付与されている必要があります。

OLEDBConnectionString に INTEGRATED SECURITY="SSPI" を設定して Windows 認証を使用する場合は、インターネット ユーザーに SQL Server テーブルの読み取り権限が付与されている必要があります。インターネット ユーザーは、次のように認証方法に基づいて識別されます。

データ アクセスおよび制約事項の詳細については、SQL Server Mobile Books Online の「サポートされているデータ型およびデータ型マッピング」および「RDA の制限事項」を参照してください。

使用例使用例
' 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 Pull Operation
    '
    rda = New SqlCeRemoteDataAccess( _
        "http://www.adventure-works.com/sqlmobile/sqlcesa30.dll",
 _
        "MyLogin", _
        "<password>", _
        "Data Source=MyDatabase.sdf")

    rda.Pull("Employees", "SELECT
 * FROM DimEmployee", rdaOleDbConnectString, _
        RdaTrackOption.TrackingOnWithIndexes, "ErrorTable")

    ' or, try one of these overloads:
    ' rda.Pull("Employees", "SELECT * FROM DimEmployee",
 rdaOleDbConnectString, _
    '     RdaTrackOption.TrackingOnWithIndexes)
    '
    ' rda.Pull("Employees", "SELECT * FROM DimEmployee",
 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 Pull Operation
    //
    rda = new SqlCeRemoteDataAccess(
        "http://www.adventure-works.com/sqlmobile/sqlcesa30.dll"
,
        "MyLogin",
        "<password>",
        "Data Source=MyDatabase.sdf");

    rda.Pull("Employees", "SELECT * FROM DimEmployee", rdaOleDbConnectString
,
        RdaTrackOption.TrackingOnWithIndexes, "ErrorTable");

    // or, try one of these overloads:
    //
    // rda.Pull("Employees", "SELECT * FROM DimEmployee",
 rdaOleDbConnectString,
    //     RdaTrackOption.TrackingOnWithIndexes);
    //
    // rda.Pull("Employees", "SELECT * FROM DimEmployee",
 rdaOleDbConnectString);
}
catch (SqlCeException)
{
    // Handle errors here
    //
}
finally
{
    // Dispose of the RDA object
    //
    rda.Dispose();
}
.NET Framework のセキュリティ.NET Framework のセキュリティ
プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照
関連項目
SqlCeRemoteDataAccess クラス
SqlCeRemoteDataAccess メンバ
System.Data.SqlServerCe 名前空間

SqlCeRemoteDataAccess.Pull メソッド (String, String, String)

リモートの Microsoft SQL Server データベースからデータをダウンロードし、ローカルの Microsoft SQL Server Mobile データベース内の単一のテーブルに格納します。

名前空間: System.Data.SqlServerCe
アセンブリ: System.Data.SqlServerCe (system.data.sqlserverce.dll 内)
構文構文

Public Sub Pull ( _
    localTableName As String, _
    sqlSelectString As String, _
    oleDBConnectionString As String _
)
Dim instance As SqlCeRemoteDataAccess
Dim localTableName As String
Dim sqlSelectString As String
Dim oleDBConnectionString As String

instance.Pull(localTableName, sqlSelectString, oleDBConnectionString)
public void Pull (
    string localTableName,
    string sqlSelectString,
    string oleDBConnectionString
)
public:
void Pull (
    String^ localTableName, 
    String^ sqlSelectString, 
    String^ oleDBConnectionString
)
public void Pull (
    String localTableName, 
    String sqlSelectString, 
    String oleDBConnectionString
)
public function Pull (
    localTableName : String, 
    sqlSelectString : String, 
    oleDBConnectionString : String
)

パラメータ

localTableName

取得された SQL Server のレコードを受け取る SQL Server Mobile のテーブルの名前。テーブルが既に存在する場合は、エラーが発生します。

sqlSelectString

SQL Server データベースから取り出して SQL Server Mobile データベースに格納するテーブル、列、レコードを指定する任意の有効な Transact-SQL ステートメント。これには SELECT ステートメントやストアド プロシージャが含まれます。

oleDBConnectionString
解説解説

SQL Server Mobile サーバー エージェントを含む仮想ディレクトリが基本認証または統合 Windows 認証を使用するように構成されている場合は、InternetLogin プロパティと InternetPassword プロパティを指定する必要があります。SQL Server のテーブルからプルするデータは、sqlSelectString によって制御します。結果のレコードセットが timestamp など、サポートされていないデータ型を含んでいる場合、エラーが発生します。sqlSelectString で WHERE 句を指定して、どのレコードを取得するかを制御できます。たとえば、SELECT * FROM Customers WHERE State='CA' は、カリフォルニア州在住の顧客だけを返します。sqlSelectString は、行を返すストアド プロシージャまたはビューもサポートしています。

SQL Server 認証を使用する場合は、OLEDBConnectionString で指定したユーザー ID に SQL Server テーブルの読み取り権限が付与されている必要があります。

OLEDBConnectionString に INTEGRATED SECURITY="SSPI" を設定して Windows 認証を使用する場合は、インターネット ユーザーに SQL Server テーブルの読み取り権限が付与されている必要があります。インターネット ユーザーは、次のように認証方法に基づいて識別されます。

データ アクセスおよび制約事項の詳細については、SQL Server Mobile Books Online の「サポートされているデータ型およびデータ型マッピング」および「RDA の制限事項」を参照してください。

使用例使用例

SqlCeRemoteDataAccess オブジェクトを作成し、いくつかのプロパティを設定して、Pull メソッドを呼び出す例を次に示します。

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

    rda.Pull("Employees", "SELECT
 * FROM DimEmployee", rdaOleDbConnectString, _
        RdaTrackOption.TrackingOnWithIndexes, "ErrorTable")

    ' or, try one of these overloads:
    ' rda.Pull("Employees", "SELECT * FROM DimEmployee",
 rdaOleDbConnectString, _
    '     RdaTrackOption.TrackingOnWithIndexes)
    '
    ' rda.Pull("Employees", "SELECT * FROM DimEmployee",
 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 Pull Operation
    //
    rda = new SqlCeRemoteDataAccess(
        "http://www.adventure-works.com/sqlmobile/sqlcesa30.dll"
,
        "MyLogin",
        "<password>",
        "Data Source=MyDatabase.sdf");

    rda.Pull("Employees", "SELECT * FROM DimEmployee", rdaOleDbConnectString
,
        RdaTrackOption.TrackingOnWithIndexes, "ErrorTable");

    // or, try one of these overloads:
    //
    // rda.Pull("Employees", "SELECT * FROM DimEmployee",
 rdaOleDbConnectString,
    //     RdaTrackOption.TrackingOnWithIndexes);
    //
    // rda.Pull("Employees", "SELECT * FROM DimEmployee",
 rdaOleDbConnectString);
}
catch (SqlCeException)
{
    // Handle errors here
    //
}
finally
{
    // Dispose of the RDA object
    //
    rda.Dispose();
}
.NET Framework のセキュリティ.NET Framework のセキュリティ
プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照
関連項目
SqlCeRemoteDataAccess クラス
SqlCeRemoteDataAccess メンバ
System.Data.SqlServerCe 名前空間

SqlCeRemoteDataAccess.Pull メソッド




英和和英テキスト翻訳

英語⇒日本語日本語⇒英語

辞書ショートカット

すべての辞書の索引

「SqlCeRemoteDataAccess.Pull」の関連用語

SqlCeRemoteDataAccess.Pullのお隣キーワード
検索ランキング

   

英語⇒日本語
日本語⇒英語
   



SqlCeRemoteDataAccess.Pullのページの著作権

   
日本マイクロソフト株式会社日本マイクロソフト株式会社
© 2026 Microsoft.All rights reserved.

©2026 GRAS Group, Inc.RSS