このトピックでは、コード例を示し、Microsoft® Excel® ワークブックのワークシート内の セルと 領域に名前または名前付き参照でアクセスする方法を説明します。参照文字列でセルと領域にアクセスする方法の詳細は、「セルとセル領域を参照」を参照してください。
このトピックには次のセクションがあります。
Microsoft Excel で、個々のセルだけでなく、セル領域は、それらに割り当てられた名前を付けることができます。名前が割り当てられて表計算の [名前] ボックスに表示されます。セルまたは領域の名前を使用して、セル参照の代わりにそのセルまたは領域を参照できます。セルおよび領域の名前は、Excel で、またはプログラムによってコードで定義できます。
個々のセルまたはセルの領域にアクセスするために、MS Excel で、またはプログラムによってコードで名前を指定する必要があります。
Excel スプレッドシートでセルまたは領域の名前を定義するには、セルまたは領域を選択し、 [名前] ボックス をクリックして、 希望の名前を入力し、Enter を押します 。
C# の場合:
// セルの名前を定義します
NamedReference instance_for_cell_NamedReference = wrkBook.NamedReferences.Add("cell_Name", "=sheet_name!cell reference", sheet_name);
// 領域の名前を定義します
NamedReference instance_for_range_NamedReference = wrkBook.NamedReferences.Add("range_Name", "=sheet_name!range cell reference", sheet_name);C# の場合:
// 名前でセルにアクセスします
sampleSheet.GetCell("cell_Name")
// 名前で領域にアクセスします
sampleSheet.GetRegion("range_Name")以下の表には、このトピックのコード例が示されています。
Worksheet オブジェクトのメソッドである GetCell と GetRegion によって、セルまたは領域にアクセスするために名前付き参照を指定することができます。
ワークシートの範囲 A1:A10 と B1:B10 内のランダムな数字。
セル B3 のために追加された参照名 - refNameB3。これは、セル B3 を右クリックすることで実行できます。コンテキスト メニューから [名前の定義] を選択します。これによって、参照名を指定できる [新しい名前] ウィンドウがポップアップされます。
領域 C1:C10 に追加される参照名 - refNameRegionC1C10。これは、範囲 C1:C10 を選択することで実行できます。コンテキスト メニューから [名前の定義] オプションを選択すると、範囲参照名を指定できる [新しい名前] ウィンドウがポップアップされます。
以下のコードはワークブックを読み込んでワークシートのインスタンスを作成します。ワークシートのセル B3 は、セルの名前付き参照を渡すことによって、GetCell メソッドを使用してアクセスされます。コメントがセル B3 に追加されます。
同様に、領域 C1:C10 は、領域の名前付き参照を渡すことによって、GetRegion メソッドを使用してアクセスされます。数式が領域 C1:C10 に適用されます。
C# の場合:
// ブックをロード
Infragistics.Documents.Excel.Workbook workBook = Infragistics.Documents.Excel.Workbook.Load(inputStream);
Infragistics.Documents.Excel.Worksheet sampleSheet = workBook.Worksheets[0];
// コメントを作成します
Infragistics.Documents.Excel.WorksheetCellComment testComment = new Infragistics.Documents.Excel.WorksheetCellComment();
Infragistics.Documents.Excel.FormattedString formatted = new Infragistics.Documents.Excel.FormattedString("This cell has a reference name.");
testComment.Text = formatted;
// セルに参照名でアクセスします
sampleSheet.GetCell("refNameB3").Comment = testComment;
// 領域に参照名でアクセスします
sampleSheet.GetRegion("refNameRegionC1C10").ApplyFormula("=A1*B1");
// 適用された変更でワークブックを保存します
workBook.Save(outputStream);Worksheet オブジェクトのメソッドである GetRegions では、領域の配列にアクセスするために名前付き参照を指定することができます。
ワークシートの領域 A3:C7、E4:G6 および I2:L5 内のランダムな数字。
複数の領域 A1:C5、E2:G4 および I7:G8 に追加された参照名 - MultipleRegions。参照の名前は、Excel で参照を選択し、[数式] -> [名前の管理] に移動することによって実行されます。[名前の管理] ウィンドウが表示します。[新規作成…] ボタンをクリックすると、[新しい名前] ウィンドウが表示します。このウィンドウで選択された範囲の名前を指定できます。
以下のコードはワークブックを読み込んでワークシートのインスタンスを作成します。領域 E4:G6 は、領域の配列を返す、GetRegions メソッドを使用して、この配列の 2 番目の要素を指定することでアクセスされます。数式は E4:G6 領域に適用されます。
C# の場合:
// ブックをロード
Infragistics.Documents.Excel.Workbook workBook = Infragistics.Documents.Excel.Workbook.Load(inputStream);
Infragistics.Documents.Excel.Worksheet sampleSheet = workBook.Worksheets[0];
// 参照名と、領域の配列内のインデックスで領域にアクセスし、その領域に数式を適用します
sampleSheet.GetRegions("MultipleRegions")[1].ApplyFormula("=$A$1*A3");
workBook.Save(outputStream);セルまたは領域を参照する NamedReference インスタンスを使用してセルまたは領域への参照を取得できます。
以下のコードは、セル、領域および領域の配列に対して NamedReference を定義し、セル、領域および領域の配列に NamedReference インスタンスからアクセスします。
C# の場合:
// ブックをロード
Infragistics.Documents.Excel.Workbook workBook =
Infragistics.Documents.Excel.Workbook.Load(inputStream)
Infragistics.Documents.Excel.Worksheet sampleSheet = workBook.Worksheets[0];
// セルの名前付き参照を定義します
Infragistics.Documents.Excel.NamedReference namedRefCell = workBook.NamedReferences.Add("NamedReferenceCell", "=Sheet1!$B$5", sampleSheet);
System.Diagnostics.Debug.WriteLine(namedRefCell.ReferencedCell.ToString());
// 領域の名前付き参照を定義します
Infragistics.Documents.Excel.NamedReference namedRefRegion = workBook.NamedReferences.Add("NamedRefRegion", "=Sheet1!$A$5:$A$10", sampleSheet);
System.Diagnostics.Debug.WriteLine(namedRefRegion.ReferencedRegion.ToString());
// 複数の領域の名前付き参照を定義します
Infragistics.Documents.Excel.NamedReference namedMultiRef = workBook.NamedReferences.Add("NamedMultiRegion",
"=Sheet1!$A$1:$B$5,Sheet1!$D$5:$G$10", sampleSheet);
System.Diagnostics.Debug.WriteLine(namedMultiRef.ReferencedRegions[1].ToString());以下のトピックでは、このトピックに関連する情報を提供しています。
以下の資料 (インフラジスティックスのコンテンツ ファミリー以外でもご利用いただけます) は、このトピックに関連する追加情報を提供します。