SqlDataSourceView クラス

リファレンス

定義

名前空間:: System.Web.UI.WebControls

アセンブリ:: System.Web.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

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

継承: Object

DataSourceView
SqlDataSourceView

派生: System.Web.UI.WebControls.AccessDataSourceView

実装: IStateManager

注釈

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

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

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

SelectCommand プロパティ
SelectParameters プロパティ
Selecting イベント
Selected イベント

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

UpdateCommand プロパティ
UpdateParameters プロパティ
Updating イベント
Updated イベント

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

InsertCommand プロパティ
InsertParameters プロパティ
Inserting イベント
Inserted イベント

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

DeleteCommand プロパティ
DeleteParameters プロパティ
Deleting イベント
Deleted イベント

データの取得中にデータのフィルター処理に使用される句が動的な場合、データの取得はより強力になります。言い換えると、静的 WHERE 句を含む SQL クエリは、WHERE 句の値が変更可能な値 (Web フォームページのコントロールに表示される値など) にバインドされる 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 実装し、ビューステートを使用してページ要求全体でその状態を追跡します。コントロールのビューステート追跡をIsTrackingViewState LoadViewState SaveViewState有効にするために、プロパティとプロパティ、、および 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, DataSourceViewOperationCallback)	DataSourceView オブジェクトで表されたデータのリストに対して、削除操作を非同期に実行します。 (継承元 DataSourceView)
Delete(IDictionary, IDictionary)	DeleteCommand SQL 文字列、DeleteParameters コレクションで指定した任意のパラメーター、および指定した `keys` コレクションと `oldValues` コレクション内の値を使用して、削除操作を実行します。
Equals(Object)	指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判断します。 (継承元 Object)
ExecuteCommand(String, IDictionary, IDictionary, DataSourceViewOperationCallback)	指定されたコマンドを実行します。 (継承元 DataSourceView)
ExecuteCommand(String, IDictionary, IDictionary)	指定されたコマンドを実行します。 (継承元 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 コレクション内の任意のパラメーター、および指定した `keys`、`values`、`oldValues` の各コレクション内の値を使用して、更新操作を実行します。
GetHashCode()	既定のハッシュ関数として機能します。 (継承元 Object)
GetType()	現在のインスタンスの Type を取得します。 (継承元 Object)
Insert(IDictionary, DataSourceViewOperationCallback)	DataSourceView オブジェクトで表されたデータのリストに対して、挿入操作を非同期に実行します。 (継承元 DataSourceView)
Insert(IDictionary)	InsertCommand SQL 文字列、InsertParameters コレクションで指定した任意のパラメーター、および指定した `values` コレクション内の値を使用して、挿入操作を実行します。
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, DataSourceViewSelectCallback)	基になるデータストレージからデータのリストを非同期に取得します。 (継承元 DataSourceView)
Select(DataSourceSelectArguments)	SelectCommand SQL 文字列、および SelectParameters コレクション内の任意のパラメーターを使用して、基になるデータベースからデータを取得します。
ToString()	現在のオブジェクトを表す文字列を返します。 (継承元 Object)
TrackViewState()	SqlDataSourceView オブジェクトがそのビューステートの変更を追跡するようにします。それにより、変更をコントロールの StateBag オブジェクトに格納して、同じページに対する複数の要求にわたって永続化できます。
Update(IDictionary, IDictionary, IDictionary, DataSourceViewOperationCallback)	DataSourceView オブジェクトで表されたデータのリストに対して、更新操作を非同期に実行します。 (継承元 DataSourceView)
Update(IDictionary, IDictionary, IDictionary)	UpdateCommand SQL 文字列、UpdateParameters コレクション内の任意のパラメーター、および指定した `keys`、`values`、`oldValues` の各コレクション内の値を使用して、更新操作を実行します。

イベント

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()」をご覧ください。

適用対象

次の方法で共有