SqlDataSourceView クラス

定義

SqlDataSource コントロールをサポートし、データ バインドされたコントロールがリレーショナル データベースに SQL データ操作を実行するためのインターフェイスを提供します。

public ref class SqlDataSourceView : System::Web::UI::DataSourceView, System::Web::UI::IStateManager
public class SqlDataSourceView : System.Web.UI.DataSourceView, System.Web.UI.IStateManager
type SqlDataSourceView = class
    inherit DataSourceView
    interface IStateManager
Public Class SqlDataSourceView
Inherits DataSourceView
Implements IStateManager
継承
SqlDataSourceView
派生
実装

注釈

クラスは SqlDataSourceView 主に、ページ コードのプログラミング可能なオブジェクトとしてではなく、データ バインド コントロールによって使用されることを目的としています。

ASP.NET データ ソース コントロールには、データ ソース ビュー オブジェクトで表される 1 つ以上のデータ リストが含まれます。 クラスは SqlDataSourceView クラスを DataSourceView 拡張し、関連付けられているコントロールの SqlDataSource 機能を定義し、データ ソース コントロールの基本的なデータ機能を実装します。 クラスはSqlDataSourceView、ビューステートに保持される設定の並べ替え、フィルター処理、管理DeleteなどSelectUpdateInsert、コントロールのデータ機能SqlDataSourceを実装します。

SqlDataSourceViewオブジェクトはコントロールによってSqlDataSourceページ開発者に直接公開されませんが、そのプロパティの多くは です。 データ ソース ビューで実行される最も基本的な操作は、 メソッドを使用して Select 基になるデータベースからデータを取得し、データ項目のコレクションを IEnumerable 取得することです。 クラスは SqlDataSourceView 、SQL クエリを使用してリレーショナル データベースからのデータ取得を実装します。 SQL クエリは、柔軟性とセキュリティを向上させるためにパラメーター化できます。 次のデータ取得メソッド、プロパティ、およびイベントは によって SqlDataSourceView 実装され、そのコントロールによって SqlDataSource ページ開発者や他の呼び出し元に直接公開されます。

オブジェクトは SqlDataSourceView 、SQL コマンドを使用したリレーショナル データベース内のデータの更新をサポートしています。 SQL コマンドは、柔軟性とセキュリティを向上させるためにパラメーター化できます。 や DetailsViewなどのGridViewデータ バインド コントロールは、 を使用してSqlDataSourceView自動的に更新を実行するように構成できますが、他のコントロールでは実行できません。 次の更新メソッド、プロパティ、およびイベントは によって SqlDataSourceView 実装され、その SqlDataSource コントロールによってページ開発者や他の呼び出し元に直接公開されます。

では SqlDataSourceView 、リレーショナル データベースへのデータの新しい行の挿入がサポートされています。 プロパティで InsertCommand 指定された SQL コマンドは、柔軟性とセキュリティを向上させるためにパラメーター化できます。 や DetailsViewなどのGridViewデータ バインド コントロールは、 を使用してSqlDataSourceView挿入を自動的に実行するように構成できますが、他のコントロールでは実行できません。 次の挿入メソッド、プロパティ、およびイベントは によって SqlDataSourceView 実装され、その SqlDataSource コントロールによってページ開発者や他の呼び出し元に直接公開されます。

オブジェクトでは SqlDataSourceView 、リレーショナル データベースからのデータの削除もサポートされています。 他のコマンドと同様に、 プロパティで DeleteCommand 指定された SQL コマンドをパラメーター化して、柔軟性とセキュリティを向上させることができます。 や DetailsViewなどのGridViewデータ バインド コントロールは、 を使用してSqlDataSourceView自動的に削除を実行するように構成できますが、他のコントロールでは実行できません。 次の削除メソッド、プロパティ、およびイベントは によって SqlDataSourceView 実装され、そのコントロールによって SqlDataSource ページ開発者や他の呼び出し元に直接公開されます。

データの取得中にデータのフィルター処理に使用される 句が動的な場合、データの取得はより強力になります。 言い換えると、静的 WHERE 句を含む SQL クエリは、WHERE 句の値が変更可能な値 (Web Forms ページのコントロールに表示される値など) にバインドされる SQL クエリほど柔軟で強力ではありません。 SQL クエリを再構築し、すべてのページ読み込みで プロパティをSelectCommand設定する代わりに、 プロパティと FilterParameters プロパティをFilterExpression使用して動的フィルター処理をデータ取得に適用できます。 これらのプロパティは によって SqlDataSourceView 実装され、その SqlDataSource コントロールによってデータ バインド コントロールや他の呼び出し元に直接公開されます。

コントロールを使用 SqlDataSource して取得したデータを並べ替えるには、ORDER BY 句を追加します。これにより、データを取得するときに、またはデータを取得した後にメモリ内のデータを並べ替えることで、データベースが順序付けを実行します。 メソッドに SqlDataSourceView 渡されるオブジェクトの プロパティを SortExpression 設定することで、 DataSourceSelectArguments に並べ替え式を Select 指定できます。 プロパティの SortExpression 構文は、プロパティの構文 DataView.Sort と同じです。 ストアド プロシージャを使用してデータを取得する場合は、 プロパティを SortParameterName 使用して、ストアド プロシージャ呼び出しの結果を並べ替えるために特に使用されるパラメーターを指定することもできます。

複数のユーザーが同時にデータベースを変更できる場合、コンカレンシーの競合が発生する可能性があります。 SqlDataSourceコントロールには、 プロパティを使用したコンカレンシーコントロールがありますSqlDataSource.ConflictDetection。 この機能は、 プロパティに SqlDataSourceView.ConflictDetection 実装されます。

他の多くの Web サーバー コントロールと同様に SqlDataSourceView 、 は インターフェイスを IStateManager 実装し、ビューステートを使用してページ要求全体でその状態を追跡します。 コントロールのビューステート追跡をIsTrackingViewStateLoadViewStateSaveViewState有効にするために、 プロパティと プロパティ、、および TrackViewState メソッドの実装が提供されます。 詳細については、「 ASP.NET State Management の概要」を参照してください。

コンストラクター

SqlDataSourceView(SqlDataSource, String, HttpContext)

指定した SqlDataSourceView コントロールを現在のビューの所有者として設定して、SqlDataSource クラスの新しいインスタンスを初期化します。

プロパティ

CancelSelectOnNullParameter

SelectParameters コレクションに格納されているパラメーターが null と評価されたときに、データ取得操作をキャンセルするかどうかを示す値を取得または設定します。

CanDelete

現在の SqlDataSourceView コントロールに関連付けられている SqlDataSource オブジェクトで削除操作がサポートされているかどうかを示す値を取得します。

CanInsert

現在の SqlDataSourceView コントロールに関連付けられている SqlDataSource オブジェクトで挿入操作がサポートされているかどうかを示す値を取得します。

CanPage

現在の SqlDataSourceView コントロールに関連付けられている SqlDataSource オブジェクトで取得データのページングがサポートされているかどうかを示す値を取得します。

CanRetrieveTotalRowCount

現在の SqlDataSourceView コントロールに関連付けられた SqlDataSource オブジェクトで、一連のデータに加えて行の合計数を取得する操作がサポートされているかどうかを示す値を取得します。

CanSort

現在の SqlDataSourceView コントロールに関連付けられている SqlDataSource オブジェクトで取得データの並べ替え済みのビューがサポートされているかどうかを示す値を取得します。

CanUpdate

現在の SqlDataSourceView コントロールに関連付けられている SqlDataSource オブジェクトで更新操作がサポートされているかどうかを示す値を取得します。

ConflictDetection

基になるデータベース内の行のデータが操作中に変更される場合に、SqlDataSource コントロールで更新と削除を実行する方法を示す値を取得または設定します。

DeleteCommand

基になるデータベースからデータを削除するために SqlDataSourceView が使用する SQL 文字列を取得または設定します。

DeleteCommandType

DeleteCommand プロパティのテキストが SQL ステートメントまたは格納されたプロシージャの名前のいずれであるかを示す値を取得または設定します。

DeleteParameters

DeleteCommand プロパティによって使用されるパラメーターを格納するパラメーター コレクションを取得します。

Events

データ ソース ビューのイベント ハンドラー デリゲートのリストを取得します。

(継承元 DataSourceView)
FilterExpression

Select メソッドが呼び出されるときに適用されるフィルター式を取得または設定します。

FilterParameters

FilterExpression 文字列のパラメーター プレースホルダーに関連付けられたパラメーターのコレクションを取得します。

InsertCommand

基になるデータベースにデータを挿入するために SqlDataSourceView オブジェクトが使用する SQL 文字列を取得または設定します。

InsertCommandType

InsertCommand プロパティのテキストが SQL ステートメントまたは格納されたプロシージャの名前のいずれであるかを示す値を取得または設定します。

InsertParameters

InsertCommand プロパティによって使用されるパラメーターを格納するパラメーター コレクションを取得します。

IsTrackingViewState

SqlDataSourceView オブジェクトがビューステートへの変更を保存しているかどうかを示す値を取得します。

Name

データ ソース ビュー名を取得します。

(継承元 DataSourceView)
OldValuesParameterFormatString

Delete メソッドまたは Update メソッドに渡される任意のパラメーター名に適用される書式指定文字列を取得または設定します。

ParameterPrefix

パラメーター化された SQL クエリ内のパラメーター プレースホルダーのプレフィックスとして使用される文字列を取得します。

SelectCommand

基になるデータベースからデータを取得するために SqlDataSourceView オブジェクトが使用する SQL 文字列を取得または設定します。

SelectCommandType

SelectCommand プロパティのテキストが SQL クエリまたは格納されたプロシージャの名前のいずれであるかを示す値を取得または設定します。

SelectParameters

SelectCommand プロパティによって使用されるパラメーターを格納するパラメーター コレクションを取得します。

SortParameterName

ストアド プロシージャを使用してデータ取得を実行する際、取得したデータの並べ替えに使用するストアド プロシージャ パラメーターの名前を取得または設定します。

UpdateCommand

基になるデータベース内のデータを更新するために SqlDataSourceView オブジェクトが使用する SQL 文字列を取得または設定します。

UpdateCommandType

UpdateCommand プロパティのテキストが SQL ステートメントまたは格納されたプロシージャの名前のいずれであるかを示す値を取得または設定します。

UpdateParameters

UpdateCommand プロパティによって使用されるパラメーターを格納するパラメーター コレクションを取得します。

メソッド

CanExecute(String)

指定したコマンドを実行できるかどうかを判断します。

(継承元 DataSourceView)
Delete(IDictionary, IDictionary)

DeleteCommand SQL 文字列、DeleteParameters コレクションで指定した任意のパラメーター、および指定した keys コレクションと oldValues コレクション内の値を使用して、削除操作を実行します。

Delete(IDictionary, IDictionary, DataSourceViewOperationCallback)

DataSourceView オブジェクトで表されたデータのリストに対して、削除操作を非同期に実行します。

(継承元 DataSourceView)
Equals(Object)

指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判断します。

(継承元 Object)
ExecuteCommand(String, IDictionary, IDictionary)

指定されたコマンドを実行します。

(継承元 DataSourceView)
ExecuteCommand(String, IDictionary, IDictionary, DataSourceViewOperationCallback)

指定されたコマンドを実行します。

(継承元 DataSourceView)
ExecuteDelete(IDictionary, IDictionary)

DeleteCommand SQL 文字列、DeleteParameters コレクションで指定した任意のパラメーター、および指定した keys コレクションと oldValues コレクション内の値を使用して、削除操作を実行します。

ExecuteInsert(IDictionary)

InsertCommand SQL 文字列、InsertParameters コレクションで指定した任意のパラメーター、および指定した values コレクション内の値を使用して、挿入操作を実行します。

ExecuteSelect(DataSourceSelectArguments)

SelectCommand SQL 文字列、および SelectParameters コレクション内の任意のパラメーターを使用して、基になるデータベースからデータを取得します。

ExecuteUpdate(IDictionary, IDictionary, IDictionary)

UpdateCommand SQL 文字列、UpdateParameters コレクション内の任意のパラメーター、および指定した keysvaluesoldValues の各コレクション内の値を使用して、更新操作を実行します。

GetHashCode()

既定のハッシュ関数として機能します。

(継承元 Object)
GetType()

現在のインスタンスの Type を取得します。

(継承元 Object)
Insert(IDictionary)

InsertCommand SQL 文字列、InsertParameters コレクションで指定した任意のパラメーター、および指定した values コレクション内の値を使用して、挿入操作を実行します。

Insert(IDictionary, DataSourceViewOperationCallback)

DataSourceView オブジェクトで表されたデータのリストに対して、挿入操作を非同期に実行します。

(継承元 DataSourceView)
LoadViewState(Object)

データ ソース ビューの、以前保存したビューステートを復元します。

MemberwiseClone()

現在の Object の簡易コピーを作成します。

(継承元 Object)
OnDataSourceViewChanged(EventArgs)

DataSourceViewChanged イベントを発生させます。

(継承元 DataSourceView)
OnDeleted(SqlDataSourceStatusEventArgs)

Deleted コントロールが削除操作を完了した後に、SqlDataSource イベントを発生させます。

OnDeleting(SqlDataSourceCommandEventArgs)

Deleting コントロールが削除操作を試行する前に、SqlDataSource イベントを発生させます。

OnFiltering(SqlDataSourceFilteringEventArgs)

Filtering コントロールが選択操作の結果をフィルター処理する前に、SqlDataSource イベントを発生させます。

OnInserted(SqlDataSourceStatusEventArgs)

Inserted コントロールが挿入操作を完了した後に、SqlDataSource イベントを発生させます。

OnInserting(SqlDataSourceCommandEventArgs)

Inserting コントロールが挿入操作を試行する前に、SqlDataSource イベントを発生させます。

OnSelected(SqlDataSourceStatusEventArgs)

Selected コントロールがデータ取得操作を完了した後に、SqlDataSource イベントを発生させます。

OnSelecting(SqlDataSourceSelectingEventArgs)

Selecting コントロールがデータ取得操作を試行する前に、SqlDataSource イベントを発生させます。

OnUpdated(SqlDataSourceStatusEventArgs)

Updated コントロールが更新操作を完了した後に、SqlDataSource イベントを発生させます。

OnUpdating(SqlDataSourceCommandEventArgs)

Updating コントロールが更新操作を試行する前に、SqlDataSource イベントを発生させます。

RaiseUnsupportedCapabilityError(DataSourceCapabilities)

ExecuteSelect(DataSourceSelectArguments) 操作に要求される機能と、ビューでサポートされ、RaiseUnsupportedCapabilitiesError(DataSourceView) メソッドによって呼び出される機能を比較します。

SaveViewState()

ページがサーバーにポストバックされてから、コントロールの SqlDataSourceView ビュー ステートに対する変更を保存します。

Select(DataSourceSelectArguments)

SelectCommand SQL 文字列、および SelectParameters コレクション内の任意のパラメーターを使用して、基になるデータベースからデータを取得します。

Select(DataSourceSelectArguments, DataSourceViewSelectCallback)

基になるデータ ストレージからデータのリストを非同期に取得します。

(継承元 DataSourceView)
ToString()

現在のオブジェクトを表す文字列を返します。

(継承元 Object)
TrackViewState()

SqlDataSourceView オブジェクトがそのビューステートの変更を追跡するようにします。それにより、変更をコントロールの StateBag オブジェクトに格納して、同じページに対する複数の要求にわたって永続化できます。

Update(IDictionary, IDictionary, IDictionary)

UpdateCommand SQL 文字列、UpdateParameters コレクション内の任意のパラメーター、および指定した keysvaluesoldValues の各コレクション内の値を使用して、更新操作を実行します。

Update(IDictionary, IDictionary, IDictionary, DataSourceViewOperationCallback)

DataSourceView オブジェクトで表されたデータのリストに対して、更新操作を非同期に実行します。

(継承元 DataSourceView)

イベント

DataSourceViewChanged

データ ソース ビューが変更された場合に発生します。

(継承元 DataSourceView)
Deleted

削除操作が完了したときに発生します。

Deleting

削除操作の前に発生します。

Filtering

フィルター操作の前に発生します。

Inserted

挿入操作が完了したときに発生します。

Inserting

挿入操作の前に発生します。

Selected

データ取得操作が完了したときに発生します。

Selecting

データ取得操作の前に発生します。

Updated

更新操作が完了したときに発生します。

Updating

更新操作の前に発生します。

明示的なインターフェイスの実装

IStateManager.IsTrackingViewState

このメンバーの詳細については、「IsTrackingViewState」をご覧ください。

IStateManager.LoadViewState(Object)

このメンバーの詳細については、「LoadViewState(Object)」をご覧ください。

IStateManager.SaveViewState()

このメンバーの詳細については、「SaveViewState()」をご覧ください。

IStateManager.TrackViewState()

このメンバーの詳細については、「TrackViewState()」をご覧ください。

適用対象

こちらもご覧ください