Worksheet インターフェイス

定義

Visual Studio の Office 開発ツールで作成された Excel プロジェクト内のワークシートを表します。Represents a worksheet in Excel projects created by using the Office development tools in Visual Studio.

[System.Runtime.InteropServices.Guid("297dc8d9-eabd-45a1-bdef-68ab67e5c3c3")]
public interface Worksheet : IDisposable, System.ComponentModel.IComponent, System.ComponentModel.ISupportInitialize, System.Windows.Forms.IBindableComponent
属性
実装

注釈

オブジェクトMicrosoft.Office.Tools.Excel.Worksheetは、Excel プライマリ相互運用機能Microsoft.Office.Interop.Excel.Worksheetアセンブリのオブジェクトと同じメンバーを提供しますが、次の機能を追加します。A Microsoft.Office.Tools.Excel.Worksheet object provides the same members as a Microsoft.Office.Interop.Excel.Worksheet object from the Excel primary interop assembly, but it adds the following features:

アプリケーションレベルのプロジェクトでは、 Microsoft.Office.Tools.Excel.Worksheet GetVstoObjectメソッドを使用して、プログラムでオブジェクトを作成できます。In application-level projects, you can create Microsoft.Office.Tools.Excel.Worksheet objects programmatically by using the GetVstoObject method. 詳細については、「 Extending Word Documents and Excel Workbooks in VSTO Add-ins at Run Time」を参照してください。For more information, see Extending Word Documents and Excel Workbooks in VSTO Add-ins at Run Time.

ドキュメントレベルのプロジェクトでは、通常、オブジェクトをMicrosoft.Office.Tools.Excel.Worksheet直接使用しません。In document-level projects, you typically do not use Microsoft.Office.Tools.Excel.Worksheet object directly. 代わりに、 nクラスSheetを使用して、プロジェクト内のワークシートにプログラムでアクセスします。Instead, use the Sheetn classes to programmatically access the worksheets in your project. Sheet nクラスは、 Microsoft.Office.Tools.Excel.WorksheetBaseクラスからそのほとんどのメンバーを派生させることができます。Each Sheetn class derives most of its members from the Microsoft.Office.Tools.Excel.WorksheetBase class. このクラスは、メンバーへのすべての呼び出しを、 Microsoft.Office.Tools.Excel.Worksheet Visual Studio Tools for Office RuntimeVisual Studio Tools for Office runtime内のインターフェイスの内部実装にリダイレクトします。This class redirects all calls to its members to an internal implementation of the Microsoft.Office.Tools.Excel.Worksheet interface in the Visual Studio Tools for Office RuntimeVisual Studio Tools for Office runtime. 詳細については、「 Programming Document-Level Customizations」を参照してください。For more information, see Programming Document-Level Customizations.

注意

これは、Visual Studio Tools for Office Runtime によって実装されたインターフェイスです。This interface is implemented by the Visual Studio Tools for Office runtime. コードに実装されるものではありません。It is not intended to be implemented in your code. 詳細については、「 Visual Studio Tools for Office Runtime Overview」を参照してください。For more information, see Visual Studio Tools for Office Runtime Overview.

使用法Usage

ここでは、.NET Framework 4 以降を対象とする Office プロジェクトで使用される型のバージョンについて説明します。This documentation describes the version of this type that is used in Office projects that target the .NET Framework 4 or later. .NET Framework 3.5 を対象とするプロジェクトでは、この型のメンバーが異なること、およびこのコード例が動作しないことがあります。In projects that target the .NET Framework 3.5, this type might have different members and the code examples provided for this type might not work. .NET Framework 3.5 を対象とするプロジェクトの型の詳細については、Visual Studio 2008 ドキュメントの次の参照セクションを参照してください。http://go.microsoft.com/fwlink/?LinkId=160658For documentation about this type in projects that target the .NET Framework 3.5, see the following reference section in the Visual Studio 2008 documentation: http://go.microsoft.com/fwlink/?LinkId=160658.

プロパティ

Application

このプロパティは、Microsoft Office Excel アプリケーションを表す Application を取得します。This property gets a Application that represents the Microsoft Office Excel application.

AutoFilter

フィルタリングが有効になっている場合にワークシートのフィルターされたリストに関する情報を提供する AutoFilter を取得します。Gets a AutoFilter that provides information about filtered lists on the worksheet if filtering is enabled. フィルタリングがオフになっている場合は null を取得します。Gets null if filtering is off.

AutoFilterMode

フィルター処理がワークシートで現在有効になっているかどうか (フィルター処理ドロップダウン矢印が現在有効になっているかどうか) を示す値を取得または設定します。Gets or sets a value that indicates whether filtering is currently enabled on the worksheet (that is, whether the filter drop-down arrows are currently displayed).

Cells

ワークシート上の全セル (現在使用中のセル以外も) を表す Range オブジェクトを取得します。Gets a Range object that represents all the cells on the worksheet (not just the cells that are currently in use).

CircularReference

ワークシート上の最初の循環参照を含む範囲を表す Range オブジェクトを取得します。ワークシートに循環参照がない場合は null を取得します。Gets a Range object that represents the range containing the first circular reference on the sheet, or gets null if there is no circular reference on the sheet.

Columns

ワークシート上の 1 つ以上の列を表す Range オブジェクトを取得します。Gets a Range object that represents one or more columns on the worksheet.

Comments

ワークシート内のすべてのコメントを示す Comments コレクションを取得します。Gets a Comments collection that represents all the comments for the worksheet.

ConsolidationFunction

現在の統合に使用される関数のコードを取得します。Gets the function code used for the current consolidation.

ConsolidationOptions

統合オプションの、3 要素の Array を取得します。Gets a three-element Array of consolidation options.

ConsolidationSources

ワークシートの現在の統合用の、参照元シートの名前と範囲を指定する、文字列の Array を取得します。Gets an Array of strings that name the source sheets and ranges for the worksheet's current consolidation.

Controls

ワークシートにあるマネージド コントロールのコレクションを取得します。Gets the collection of managed controls that are contained on the worksheet.

Creator

ワークシートを作成したアプリケーションを示す値を取得します。Gets a value that indicates the application in which the worksheet was created.

CustomProperties

ワークシートに関連付けられた識別情報を表す CustomProperties オブジェクトを取得します。Gets a CustomProperties object representing the identifier information associated with a worksheet.

DataHost
DefaultExtension

この Worksheet オブジェクトの既定の拡張機能を取得します。Gets the default extension for this Worksheet object.

DisplayPageBreaks

ワークシート上の改ページ (自動と手動の両方) を表示するかどうかを示す値を取得または設定します。Gets or sets a value that indicates whether page breaks (both automatic and manual) on the worksheet are displayed.

DisplayRightToLeft

ワークシートを左から右ではなく、右から左へ表示するかどうかを示す値を取得または設定します。Gets or sets a value that indicates whether the worksheet is displayed from right to left instead of from left to right.

EnableAutoFilter

ユーザー インターフェイスのみの保護がオンになっているときに、オートフィルターの矢印が有効になっているかどうかを示す値を取得または設定します。Gets or sets a value that indicates whether AutoFilter arrows are enabled when user-interface-only protection is turned on.

EnableCalculation

Microsoft Office Excel が必要に応じて自動的にワークシートを再計算するかどうかを示す値を取得または設定します。Gets or set a value that indicates whether Microsoft Office Excel automatically recalculates the worksheet when necessary.

EnableFormatConditionsCalculation

条件付き書式が自動的に適用されるかどうかを決定する値を取得または設定します。Gets or sets a value that determines whether conditional formats will occur automatically.

EnableOutlining

ユーザー インターフェイスのみの保護がオンになっているときに、アウトライン記号が有効になっているかどうかを示す値を取得または設定します。Gets or sets a value that indicates whether outlining symbols are enabled when user-interface-only protection is turned on.

EnablePivotTable

ユーザー インターフェイスのみの保護がオンになっているときに、PivotTable のコントロールとアクションが有効になっているかどうかを示す値を取得または設定します。Gets or sets a value that indicates whether PivotTable controls and actions are enabled when user-interface-only protection is turned on.

EnableSelection

シート上で選択可能なセルを示す値を取得または設定します。Gets or sets a value indicating which cells can be selected on the sheet.

Extension

この Worksheet オブジェクトのカスタムの拡張機能を取得します。Gets a custom extension for this Worksheet object.

FilterMode

ワークシートがアクティブにデータをフィルター処理するかどうかを示す値を取得します。Gets a value that indicates whether the worksheet is actively filtering data.

HostContext
HPageBreaks

ワークシート上の水平方向の改ページを表す HPageBreaks コレクションを取得します。Gets an HPageBreaks collection that represents the horizontal page breaks on the sheet.

Hyperlinks

範囲またはワークシートのハイパーリンクを表す Hyperlinks コレクションを取得します。Gets a Hyperlinks collection that represents the hyperlinks for the range or worksheet.

Index

ワークシートのコレクション内の、特定のワークシートのインデックス番号を取得します。Gets the index number of the worksheet within the collection of worksheets.

InnerObject

Worksheet の基になるネイティブ オブジェクトを表す Worksheet を取得します。Gets a Worksheet that represents the underlying native object for the Worksheet.

ItemProvider
ListObjects

ワークシート内の ListObject オブジェクトのコレクションを取得します。Gets a collection of ListObject objects in the worksheet.

MailEnvelope

ワークシートの電子メール ヘッダーを取得します。Gets an e-mail header for the worksheet.

Name

ワークシートの名前を取得または設定します。Gets or sets the name of the worksheet.

Names

すべてのワークシート固有の名前 ("WorksheetName!" プレフィックスで定義されている名前) を表す Names コレクションを取得しますGets a Names collection that represents all the worksheet-specific names (names defined with the "WorksheetName!" prefix).

Next

次のシートを表す Worksheet を取得します。Gets a Worksheet that represents the next sheet.

Outline

ワークシートのアウトラインを表す Outline を取得します。Gets an Outline that represents the outline for the worksheet.

PageSetup

ワークシートのすべてのページ設定を含む PageSetup を取得します。Gets a PageSetup that contains all the page setup settings for the worksheet.

Parent

ワークシートの親オブジェクトを取得します。Gets the parent object for the worksheet.

Previous

前のシートを表す Worksheet を取得します。Gets a Worksheet that represents the previous sheet.

PrintedCommentPages

現在のワークシートで印刷されるコメント ページの数を取得します。Gets the number of comment pages that will be printed for the current worksheet.

ProtectContents

ワークシート (個々のセル) の内容が保護されているかどうかを示す値を取得します。Gets a value that indicates whether the contents of the worksheet (the individual cells) are protected.

ProtectDrawingObjects

図形が保護されているかどうかを示す値を取得します。Gets a value that indicates whether shapes are protected.

Protection

ワークシートの保護オプションを表す Protection オブジェクトを取得します。Gets a Protection object that represents the protection options of the worksheet.

ProtectionMode

ユーザー インターフェイスのみの保護がオンになっているかどうかを示す値を取得します。Gets a value that indicates whether user interface-only protection is turned on.

ProtectScenarios

ワークシートのシナリオが保護されているかどうかを示す値を取得します。Gets a value that indicates whether worksheet scenarios are protected.

QueryTables

ワークシート内のすべてのクエリ テーブルを示す QueryTables コレクションを取得します。Gets the QueryTables collection that represents all the query tables on the worksheet.

Range

セルまたはセルの範囲を表す Range オブジェクトを取得します。Gets a Range object that represents a cell or a range of cells.

Rows

ワークシート上の 1 つ以上の行を表す Range オブジェクトを取得します。Gets a Range object that represents one or more rows on the worksheet.

ScrollArea

スクロール可能な範囲を、A1 スタイルの範囲参照として取得または設定します。Gets or sets the range where scrolling is allowed, as an A1-style range reference.

Shapes

ワークシート上のすべての図形を表す Shapes オブジェクトを取得します。Gets a Shapes object that represents all the shapes on the worksheet.

Sort

現在のワークシート内で並べ替えた値を取得します。Gets the sorted values in the current worksheet.

StandardHeight

ワークシート内のすべての行の標準 (既定) の高さをポイントで取得します。Gets the standard (default) height of all the rows in the worksheet, in points.

StandardWidth

ワークシート内の列の標準 (既定) の高さを取得または設定します。Gets or sets the standard (default) width of all the columns in the worksheet.

Tab

ワークシートの Tab を取得します。Gets a Tab for the worksheet.

Tag

ワークシートに関するデータが含まれるオブジェクトを取得または設定します。Gets or sets the object that contains data about the worksheet.

TransitionExpEval

Microsoft Office Excel が Lotus 1-2-3 の式評価規則をワークシートで使用するかどうかを示す値を取得または設定します。Gets or sets a value that indicates whether Microsoft Office Excel uses Lotus 1-2-3 expression evaluation rules for the worksheet.

TransitionFormEntry

Microsoft Office Excel が Lotus 1-2-3 の数式入力規則をワークシートで使用するかどうかを示す値を取得または設定します。Gets or sets a value that indicates whether Microsoft Office Excel uses Lotus 1-2-3 formula entry rules for the worksheet.

Type

ワークシートの種類を取得します。Gets the worksheet type.

UsedRange

任意の時点で値を含んでいたすべてのセルを表す Range オブジェクトを取得します。Gets a Range object that represents all the cells that have contained a value at any time.

Visible

オブジェクトが表示されるかどうかを示す XlSheetVisibility 値を取得または設定します。Gets or sets a XlSheetVisibility value that determines whether the object is visible.

VPageBreaks

ワークシート上の垂直方向の改ページを表す VPageBreaks コレクションを取得します。Gets a VPageBreaks collection that represents the vertical page breaks on the sheet.

メソッド

Activate()

現在のワークシートをアクティブ シートにします。Makes the current sheet the active sheet.

CalculateMethod()

ワークシート内の数式を演算します。Calculates the formulas in the worksheet.

ChartObjects(Object)

ワークシート上の単一の埋め込みグラフ (ChartObject) または、すべての埋め込みグラフのコレクション (ChartObjects) のいずれかを表すオブジェクトを取得します。Gets an object that represents either a single embedded chart (a ChartObject) or a collection of all the embedded charts (a ChartObjects) on the worksheet.

CheckSpelling(Object, Object, Object, Object)

ワークシート内でスペル チェックを行います。Checks the spelling in a worksheet.

CircleInvalid()

ワークシート上の無効なエントリを丸で囲みます。Circles invalid entries on the worksheet.

ClearArrows()

トレース矢印をワークシートから削除します。Clears the tracer arrows from the worksheet. トレース矢印は、監査機能を使用することで追加されます。Tracer arrows are added by using the auditing feature.

ClearCircles()

ワークシート上の無効なエントリの丸を削除します。Clears circles from invalid entries on the worksheet.

Copy(Object, Object)

ワークシートをブック内の別の場所にコピーします。Copies the worksheet to another location in the workbook.

Delete()

基になる Worksheet オブジェクトは削除されますが、ホスト項目は削除されません。Deletes the underlying Worksheet object, but does not delete the host item. このメソッドを使用しないことを強くお勧めします。It is highly recommended that this method not be used.

Evaluate(Object)

Microsoft Office Excel の名前をオブジェクトまたは値に変換します。Converts a Microsoft Office Excel name to an object or a value.

ExportAsFixedFormat(XlFixedFormatType, Object, Object, Object, Object, Object, Object, Object, Object)

指定した書式のファイルにエクスポートします。Exports to a file of the specified format.

Move(Object, Object)

ワークシートをブック内の他の場所に移動します。Moves the worksheet to another location in the workbook.

OLEObjects(Object)

ワークシート上の単一の OLE オブジェクト (OLEObject) または、すべての OLE オブジェクトのコレクション (OLEObjects コレクション) のいずれかを表すオブジェクトを取得します。Gets an object that represents either a single OLE object (an OLEObject) or a collection of all OLE objects (an OLEObjects collection) on the worksheet.

Paste(Object, Object)

クリップボードの内容をワークシートに貼り付けます。Pastes the contents of the Clipboard onto the worksheet.

PasteSpecial(Object, Object, Object, Object, Object, Object, Object)

クリップボードの内容を、指定された形式でワークシートに貼り付けます。Pastes the contents of the Clipboard onto the worksheet, using a specified format. 他のアプリケーションからデータを貼り付ける場合、または特定の形式でデータを貼り付ける場合、このメソッドを使用します。Use this method to paste data from other applications or to paste data in a specific format.

PivotTables(Object)

ワークシート上の単一のピボットテーブル レポート (PivotTable オブジェクト) または、すべてのピボットテーブル レポートのコレクション (PivotTables オブジェクト) のいずれかを表すオブジェクトを取得します。Gets an object that represents either a single PivotTable report (a PivotTable object) or a collection of all the PivotTable reports (a PivotTables object) on a worksheet.

PivotTableWizard(Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object)

PivotTable オブジェクトを作成します。Creates a PivotTable object.

PrintOutEx(Object, Object, Object, Object, Object, Object, Object, Object, Object)

ワークシートを印刷します。Prints the worksheet.

PrintPreview(Object)

印刷されたときのワークシートのプレビューを示します。Shows a preview of the worksheet as it would look when printed.

Protect(Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object)

ワークシートを変更できないよう保護します。Protects a worksheet so that it cannot be modified.

ResetAllPageBreaks()

指定されたワークシート上のすべての改ページをリセットします。Resets all page breaks on the specified worksheet.

SaveAs(String, Object, Object, Object, Object, Object, Object, Object, Object, Object)

ワークシートへの変更を別のファイルに保存します。Saves changes to the worksheet in a different file.

Scenarios(Object)

ワークシート上の単一のシナリオ (Scenario オブジェクト) または、シナリオのコレクション (Scenarios オブジェクト) のいずれかを表すオブジェクトを取得します。Gets an object that represents either a single scenario (a Scenario object) or a collection of scenarios (a Scenarios object) on the worksheet.

Select(Object)

ワークシートを選択します。Selects the worksheet.

SetBackgroundPicture(String)

ワークシートの背景グラフィックを設定します。Sets the background graphic for the worksheet.

ShowAllData()

現在フィルターされたリストのすべての行を表示します。Makes all rows of the currently filtered list visible. オートフィルター が使用されている場合、このメソッドは矢印を "すべて" に変更します。If AutoFilter is in use, this method changes the arrows to "All."

ShowDataForm()

ワークシートに関連付けられたデータ フォームを表示します。Displays the data form associated with the worksheet.

Unprotect(Object)

ワークシートの保護を削除します。Removes protection from the worksheet. このメソッドは、ワークシートが保護されていないときには何もしません。This method has no effect if the worksheet is not protected.

XmlDataQuery(String, Object, Object)

特定の XPath にマップされているセルを表す Range オブジェクトを取得します。Gets a Range object that represents the cells mapped to a particular XPath. 指定された XPath がワークシートにマップされていない場合、またはマップされた範囲が空の場合は null を取得します。Gets null if the specified XPath has not been mapped to the worksheet, or if the mapped range is empty.

XmlMapQuery(String, Object, Object)

特定の XPath にマップされているセルを表す Range オブジェクトを取得します。Gets a Range object that represents the cells mapped to a particular XPath. 指定された XPath がワークシートにマップされていない場合は null を取得します。Gets null if the specified XPath has not been mapped to the worksheet.

イベント

ActivateEvent

ワークシートがアクティブになると発生します。Occurs when the worksheet is activated.

BeforeDoubleClick

ワークシートがダブルクリックされたとき、既定のダブルクリック処理が行われる前に発生します。Occurs when the worksheet is double-clicked, before the default double-click action.

BeforeRightClick

ワークシートが右クリックされたとき、既定の右クリック処理が行われる前に発生します。Occurs when the worksheet is right-clicked, before the default right-click action.

BindingContextChanged
Calculate

ワークシートが再計算された後で発生します。Occurs after the worksheet is recalculated.

Change

Worksheet のセルで何か変更があった場合に発生します。Occurs when something changes in the Worksheet cells.

Deactivate

ワークシートがフォーカスを失ったときに発生します。Occurs when the worksheet loses focus.

FollowHyperlink

ワークシート内のハイパーリンクがクリックされると発生します。Occurs when you click any hyperlink on a worksheet.

PivotTableAfterValueChange

ピボットテーブル内のセルまたはセル範囲の編集後、または (数式が含まれているセルの) 再計算後に発生します。Occurs after a cell or range of cells inside a PivotTable are edited or recalculated (for cells that contain formulas).

PivotTableBeforeAllocateChanges

変更がピボットテーブルに適用される前に発生します。Occurs before changes are applied to a PivotTable.

PivotTableBeforeCommitChanges

ピボットテーブルの OLAP データ ソースに対して変更がコミットされる前に発生します。Occurs before changes are committed against the OLAP data source for a PivotTable.

PivotTableBeforeDiscardChanges

ピボットテーブルに対する変更が破棄される前に発生します。Occurs before changes to a PivotTable are discarded.

PivotTableChangeSync

ピボットテーブルに対する変更後に発生します。Occurs after changes to a PivotTable.

PivotTableUpdate

ワークシートでピボットテーブル レポートが更新されると発生します。Occurs after a PivotTable report is updated on a worksheet.

SelectionChange

ワークシートで選択範囲が変更されると発生します。Occurs when the selection changes on a worksheet.

Shutdown

ワークシートのホスト項目がシャットダウンすると発生します。Occurs when the worksheet host item shuts down.

Startup

ワークシートが実行され、アセンブリ内のすべての初期化コードが実行された後に発生します。Occurs after the worksheet is running and all the initialization code in the assembly has been run.

適用対象