DataGridViewRow.SetValues メソッド

.NET Framework クラス ライブラリ リファレンス

DataGridViewRow.SetValues メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

行のセルの値を設定します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Public Function SetValues ( _
    ParamArray values As Object()
 _
) As Boolean

Visual Basic (使用法)

Dim instance As DataGridViewRow
Dim values As Object()
Dim returnValue As Boolean

returnValue = instance.SetValues(values)

C#

public bool SetValues (
    params Object[] values
)

C++

public:
bool SetValues (
    ... array<Object^>^ values
)

J#

public boolean SetValues (
    Object[] values
)

JScript

public function SetValues (
    ... values : Object[]
) : boolean

パラメータ

values

行内のセルの値を表す 1 つ以上のオブジェクト。

または

Object の値の Array。

戻り値
すべての値が設定された場合は true。それ以外の場合は false。

例外

例外の種類	条件
ArgumentNullException	values が null 参照 (Visual Basic では Nothing) です。
InvalidOperationException	関連付けられた DataGridView が仮想モードで動作しているときに、このメソッドが呼び出されています。 または この行は共有行です。

解説

values パラメータは、セルの値を行に読み込むために使用される可変数の引数を表します。これらの値は、複数の引数、個々の引数、または単一の Array のメンバとして、このメソッドに渡すことができます。ただし、これらの値は Object 型のインスタンスである必要があるため、値型の値 (Int32 値など) の配列を渡した場合、このメソッドは、その配列を単一のオブジェクトとして扱い、単一のセルに割り当てます。この動作を回避するには、値型の配列を Object 配列にキャストするか、複数の値を複数の引数として渡す必要があります。

values リスト内の値が、初期化するセルの数よりも多い場合は、このメソッドは余分な値を無視し、false を返します。このメソッドは、指定された中に設定できない値がある場合も false を返します。

セルの数よりも値の数が少ない場合、対応する要素がない残りのセルは、現在の値のままとなります。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
DataGridViewRow クラス
DataGridViewRow メンバ
System.Windows.Forms 名前空間
DataGridView クラス
CreateCells
DataGridViewCell.SetValue
DataGridView.VirtualMode プロパティ
その他の技術情報
Windows フォーム DataGridView コントロールを拡張するための推奨される手順