クラス デザイナーでの型メンバーの作成および構成
これらのメンバーをクラス ダイアグラムの型に追加して、メンバーを [クラスの詳細] ウィンドウで構成することができます。
| Type | 含めることのできるメンバー |
|---|---|
| クラス | メソッド、プロパティ (C# と Visual Basic の場合)、フィールド、イベント (C# と Visual Basic の場合)、コンストラクター (メソッド)、デストラクター (メソッド)、定数 |
| Enum | member |
| Interface | メソッド、プロパティ、イベント (C# と Visual Basic の場合) |
| 抽象クラス | メソッド、プロパティ (C# と Visual Basic の場合)、フィールド、イベント (C# と Visual Basic の場合)、コンストラクター (メソッド)、デストラクター (メソッド)、定数 |
| 構造体 (C# の構造体) | メソッド、プロパティ (C# と Visual Basic の場合)、フィールド、イベント (C# と Visual Basic の場合)、コンストラクター (メソッド)、定数 |
| Delegate | パラメーター |
| モジュール (VB の場合のみ) | メソッド、プロパティ、フィールド、イベント、コンストラクター、定数 |
Note
自動実装するプロパティを使用すると、このプロパティの get アクセサーと set アクセサーで追加のロジックが必要ない場合に、プロパティ宣言がより簡単になります (C# の場合のみ)。 完全署名を表示するには、 [クラス ダイアグラム] メニューで [メンバー形式の変更]>[完全署名の表示] の順に選択します。 自動実装するプロパティの詳細については、「自動実装するプロパティ」を参照してください。
一般的なタスク
| タスク | 関連する参照先 |
|---|---|
| 作業の開始: 型のメンバーを作成および構成する前に、 [クラスの詳細] ウィンドウを開く必要があります。 | - [クラスの詳細] ウィンドウを開く - クラスの詳細の使用上の注意 - 読み取り専用の情報の表示 - クラス ダイアグラムおよびクラスの詳細情報のウィンドウでのキーボードとマウスのショートカット |
| 型のメンバーの作成および変更:[クラスの詳細] ウィンドウを使用して、新しいメンバーの作成、メンバーの変更、およびメソッドへのパラメーターの追加を行うことができます。 | - メンバーの作成 - 型のメンバーの変更 - メソッドへのパラメーターの追加 |
[クラスの詳細] ウィンドウを開く
既定では、 [クラスの詳細] ウィンドウは、新しいクラス ダイアグラムを開くと自動的に表示されます。 ｢プロジェクトにクラス ダイアグラムを追加する)」を参照してください。 また、 [クラスの詳細] ウィンドウは、次の方法でも開くことができます。
ダイアグラム内の任意のクラスを右クリックしてコンテキスト メニューを表示し、 [クラスの詳細] を選択します。
メニュー バーで [表示]>[その他のウィンドウ]>[クラスの詳細] の順に選択します。
メンバーの作成
次のいずれかのツールを使用して、メンバーを作成できます。
クラス デザイナー
[クラスの詳細] ウィンドウ ツール バー
[クラスの詳細] ウィンドウ
Note
このセクションの手順に従って、コンストラクターとデストラクターを作成することもできます。 コンストラクターとデストラクターは特殊なメソッドであるため、クラス ダイアグラムの図形の [メソッド] コンパートメントと [クラスの詳細] ウィンドウ グリッドの [メソッド] セクションに表示されることに注意してください。
Note
デリゲートに追加できるエンティティはパラメーターだけです。 「 [クラスの詳細] ウィンドウ ツール バーを使用してメンバーを作成するには」の手順は、この処理には有効ではありません。
クラス デザイナーを使用してメンバーを作成する
メンバーを追加する型を右クリックして [追加] をポイントし、追加するメンバーの型を選択します。
新しいメンバー シグネチャが作成され、型に追加されます。 クラス デザイナー、 [クラスの詳細] ウィンドウ、または [プロパティ] ウィンドウで変更できる既定の名前が与えられます。
オプションとして、型など、メンバーに関するその他の詳細を指定します。
[クラスの詳細] ウィンドウ ツール バーを使用してメンバーを作成する
ダイアグラム領域で、メンバーを追加する型を選択します。
型がフォーカスを取得し、その内容が [クラスの詳細] ウィンドウに表示されます。
[クラスの詳細] ウィンドウ ツール バーで、上部のアイコンをクリックし、ドロップダウン リストの [新しい <メンバー>] をクリックします。
カーソルが追加するメンバーの種類の列の名前フィールドに移動します。 たとえば、 [新しいプロパティ] をクリックすると、 [クラスの詳細] ウィンドウの [プロパティ] セクションの新しい行にカーソルが移動します。
作成するメンバーの名前を入力し、Enter キーを押します (または、Tab キーの押下などによりフォーカスを移動します)。
新しいメンバー シグネチャが作成され、型に追加されます。 これで、メンバーのコードへの追加が完了し、クラス デザイナー、 [クラスの詳細] ウィンドウ、および [プロパティ] ウィンドウに表示されます。
オプションとして、型など、メンバーに関するその他の詳細を指定します。
[クラスの詳細] ウィンドウを使用してメンバーを作成する
ダイアグラム領域で、メンバーを追加する型を選択します。
型がフォーカスを取得し、その内容が [クラスの詳細] ウィンドウに表示されます。
[クラスの詳細] ウィンドウの、追加するメンバーの種類を含むセクションで、[<メンバーの追加>] をクリックします。 たとえば、フィールドを追加する場合は [<フィールドの追加>] をクリックします。
作成するメンバーの名前を入力し、Enter キーを押します。
新しいメンバー シグネチャが作成され、型に追加されます。 これで、メンバーのコードへの追加が完了し、クラス デザイナー、 [クラスの詳細] ウィンドウ、および [プロパティ] ウィンドウに表示されます。
オプションとして、型など、メンバーに関するその他の詳細を指定します。
Note
キーボード ショートカットを使用してメンバーを作成することもできます。 詳細については、「クラス ダイアグラムおよびクラスの詳細情報のウィンドウでのキーボードとマウスのショートカット」を参照してください。
型のメンバーの変更
クラス デザイナーを使用して、ダイアグラムに表示される型のメンバーを変更できます。 読み取り専用でない、クラス ダイアグラムに表示される任意の型のメンバーを変更できます。 型のメンバーは、デザイン サーフェイス、プロパティ ウィンドウ、および [クラスの詳細] ウィンドウで埋め込み先編集を使用して変更します。
[クラスの詳細] ウィンドウに表示されるすべてのメンバーは、クラス ダイアグラムの型のメンバーを表します。 メソッド、プロパティ、フィールド、およびイベントという 4 種類のメンバーがあります。
すべてのメンバー行は、メンバーを種類別にグループ化する見出しの下に表示されます。 たとえば、すべてのプロパティは、グリッドのノードとして縮小または展開できる見出し [プロパティ] の下に表示されます。
各メンバー行には、次の要素が表示されます。
メンバー アイコン
各種メンバーは、独自のアイコンで表されます。 メンバー アイコンをマウスでポイントすると、メンバーのシグネチャが表示されます。 メンバー アイコンまたはメンバー アイコンの左の空白をクリックすると、その行が選択されます。
メンバー名
メンバー行の [名前] 列には、メンバーの名前が表示されます。 この名前は、[プロパティ] ウィンドウの [名前] プロパティにも表示されます。 このセルを使用して、読み書き可能アクセス許可を持つ任意のメンバーの名前を変更します。
[名前] 列が狭すぎて名前全体を表示できない場合は、メンバー名をマウスでポイントするとメンバーの名前が表示されます。
メンバーの型
[メンバーの型] セルでは、IntelliSense を使用します。IntelliSense では、現在のプロジェクトまたは参照先プロジェクトで使用できるすべての型の一覧から選択できます。
メンバー修飾子
Public(public)、Private(private)、Friend(internal)Protected(protected)、Protected Friend(protected internal)、Defaultのいずれかにメンバーの可視性修飾子を変更します。<メンバーの追加>
[クラスの詳細] ウィンドウの最後の行には、[名前] セルに <メンバーの追加> というテキストが表示されます。 このセルをクリックすると、新しいメンバーを作成できます。 詳細については、「メンバーの作成」を参照してください。
[プロパティ] ウィンドウでのメンバーのプロパティ
[クラスの詳細] ウィンドウには、[プロパティ] ウィンドウに表示されるメンバーのプロパティのサブセットが表示されます。 ある場所のプロパティを変更すると、プロパティの値がグローバルに更新されます。 つまり、他の場所でのその値の表示も更新されます。
まとめ
[概要] セルでは、メンバーに関する情報の概要が公開されます。 [概要] セルの省略記号をクリックすると、メンバーの [概要] 、 [リターン] 、および [コメント] に関する情報を表示または編集できます。
[非表示]
[非表示] チェック ボックスがオンの場合は、メンバーが型に表示されません。
型のメンバーを変更するには
クラス デザイナーを使用して型を選択します。
[クラスの詳細] ウィンドウが表示されていない場合、クラス デザイナー ツール バーの [クラスの詳細] ウィンドウ ボタンをクリックします。
[クラスの詳細] ウィンドウのグリッドでフィールドの値を編集します。 各編集の後に Enter キーを押すか、Tab キーを押すなどして、編集したフィールドからフォーカスを移動します。 編集内容は、コードに即時に反映されます。
Note
メンバーの名前だけを変更する場合でも、埋め込み先での編集を使用して変更できます。
メソッドへのパラメーターの追加
[クラスの詳細] ウィンドウを使用して、メソッドにパラメーターを追加します。 パラメーターは、必須の場合または省略可能に構成できます。 パラメーターの 省略可能な既定値 プロパティに値を指定すると、デザイナーで省略可能なパラメーターとしてコードが生成されます。
パラメーター行には次の項目が含まれます。
Name
パラメーター行の [名前] 列には、パラメーターの名前が表示されます。 この名前は、[プロパティ] ウィンドウの [名前] プロパティにも表示されます。 このセルを使用して、読み書き可能アクセス許可を持つ任意のパラメーターの名前を変更できます。
[名前] 列が狭すぎて名前全体を表示できない場合は、パラメーター名をポイントするとパラメーターの名前が表示されます。
Type
[パラメーターの型] セルでは、IntelliSense を使用します。IntelliSense では、現在のプロジェクトまたは参照先プロジェクトで使用できるすべての型の一覧から選択できます。
修飾子
パラメーター行の [修飾子] セルは、パラメーターの新しい修飾子を受け入れ、表示します。 新しいパラメーター修飾子を入力するには、ドロップダウン リスト ボックスを使用して、 [None] 、 [ref] 、 [out] 、または [params] (C# の場合)、または [ByVal] 、 [ByRef] 、または [ParamArray] (VB の場合) から選択します。
まとめ
パラメーター行の [概要] セルでは、コード エディターにパラメーターを入力するときに IntelliSense に表示されるコードのコメントを入力できます。
<パラメーターの追加>
メンバーの最後のパラメーター行には、[名前] セルに <パラメーターの追加> というテキストが表示されます。 このセルをクリックして、新しいパラメーターを作成できます。 詳細については、「メソッドにパラメーターを追加するには」を参照してください。
[プロパティ] ウィンドウには、 [クラスの詳細] ウィンドウに表示されるのと同じパラメーターのプロパティ ( [名前] 、 [型] 、 [修飾子] 、 [概要] 、 [省略可能な既定値] ) が表示されます。 ある場所でプロパティを変更すると、プロパティの値がグローバルに更新され、他の場所でのその値の表示も更新されます。
注意
パラメーターをデリゲートに追加するには、「メンバーの作成」を参照してください。
Note
デストラクターはメソッドですが、パラメーターを持つことはできません。
メソッドにパラメーターを追加するには
ダイアグラム領域で、パラメーターを追加するメソッドを含む型をクリックします。
型がフォーカスを取得し、その内容が [クラスの詳細] ウィンドウに表示されます。
[クラスの詳細] ウィンドウで、パラメーターを追加するメソッドの行を展開します。
インデントを設定したパラメーター行が表示され、かっこのペアと [<パラメーターの追加>] という語だけが表示されます。
[<パラメーターの追加>] をクリックし、新しいパラメーターの名前を入力し、Enter キーを押します。
新しいパラメーターがメソッドおよびメソッドのコードに追加されます。 このパラメーターは [クラスの詳細] ウィンドウと [プロパティ] ウィンドウに表示されます。
オプションとして、型など、パラメーターに関するその他の詳細を指定します。
メソッドに省略可能なパラメーターを追加するには
ダイアグラム領域で、省略可能なパラメーターを追加するメソッドを含む型をクリックします。
型がフォーカスを取得し、その内容が [クラスの詳細] ウィンドウに表示されます。
[クラスの詳細] ウィンドウで、省略可能なパラメーターを追加するメソッドの行を展開します。
インデントを設定したパラメーター行が表示され、かっこのペアと [<パラメーターの追加>] という語だけが表示されます。
[<パラメーターの追加>] をクリックし、新しいパラメーターの名前を入力し、Enter キーを押します。
新しいパラメーターがメソッドおよびメソッドのコードに追加されます。 このパラメーターは [クラスの詳細] ウィンドウと [プロパティ] ウィンドウに表示されます。
プロパティ ウィンドウで、省略可能な既定値 プロパティの値を入力します。 パラメーターの "省略可能な既定値" プロパティを設定すると、そのパラメーターは省略可能になります。
注意
省略可能なパラメーターは、パラメーター リストの最後のパラメーターにする必要があります。
クラスの詳細の使用上の注意
[クラスの詳細] ウィンドウを使用する場合は、次のヒントに注意してください。
編集できるセルと編集できないセル
[クラスの詳細] ウィンドウのすべてのセルは、次のいくつかの例外を除いて編集できます。
たとえば、参照アセンブリに存在する場合などは、型全体が読み取り専用です。 クラス デザイナーで図形を選択すると、 [クラスの詳細] ウィンドウにその詳細が読み取り専用状態で表示されます。
インデクサーの場合、名前は読み取り専用でその他 (型、修飾子、概要) は編集できます。
[クラスの詳細] ウィンドウでは、すべてのジェネリックが読み取り専用パラメーターを持ちます。 ジェネリック パラメーターを変更するには、そのソース コードを編集します。
ジェネリック型で定義されている型パラメーターの名前は読み取り専用です。
型のコードが壊れている (解析できない) 場合は、 [クラスの詳細] ウィンドウに型の内容が読み取り専用として表示されます。
[クラスの詳細] ウィンドウとソース コード
[クラスの詳細] ウィンドウ (またはクラス デザイナー) で図形を右クリックし、[コードの表示] をクリックすることにより、ソース コードを表示できます。 ソース コード ファイルが開き、選択した要素にスクロールします。
ソース コードの変更は、クラス デザイナーおよび [クラスの詳細] ウィンドウのシグネチャ情報の表示に即時に反映されます。 その時点で [クラスの詳細] ウィンドウが閉じている場合は、次にこのウィンドウを開いたときに新しい情報が表示されます。
型のコードが壊れている (解析できない) 場合は、 [クラスの詳細] ウィンドウに型の内容が読み取り専用として表示されます。
[クラスの詳細] ウィンドウのクリップボード機能
[クラスの詳細] ウィンドウからフィールドまたは行をコピーするか切り取り、別の型に貼り付けることができます。 行は、読み取り専用でない場合にだけ切り取ることができます。 行を貼り付けるときに、 [クラスの詳細] ウィンドウでは、競合を回避するために新しい名前 (コピーした行の名前から派生した名前) が割り当てられます。
読み取り専用の情報の表示
クラス デザイナーと [クラスの詳細] ウィンドウには、次の項目の型 (および型のメンバー) を表示できます。
クラス ダイアグラムを含むプロジェクト
クラス ダイアグラムを含むプロジェクトから参照されるプロジェクト
クラス ダイアグラムを含むプロジェクトから参照されるアセンブリ
後の 2 つでは、参照されるエンティティ (型またはメンバー) は、そのエンティティを表すクラス ダイアグラムで読み取り専用になります。
プロジェクト全体またはプロジェクトの一部 (個々のファイルなど) が読み取り専用の場合があります。 プロジェクトまたはそのいずれかのファイルが読み取り専用である最も一般的なケースは、ソース コード管理の対象である (およびチェックアウトされていない) 場合、外部アセンブリに存在する場合、またはオペレーティング システムがファイルを読み取り専用と見なす場合です。
ソース コード管理
クラス ダイアグラムはプロジェクトにファイルとして保存されるため、クラス デザイナーまたは [クラスの詳細] ウィンドウで行う変更を保存するにはプロジェクトをチェックアウトする必要があります。
読み取り専用プロジェクト
プロジェクトは、ソース コード管理以外の理由で読み取り専用の場合があります。 プロジェクトを閉じると、プロジェクト ファイルを上書きするか、変更を破棄する (保存しない) か、または閉じる操作をキャンセルするかを確認するダイアログ ボックスが表示されます。 上書きを選択した場合は、プロジェクト ファイルが上書きされ、読み書き可能になります。 新しいクラス ダイアグラム ファイルが追加されます。
読み取り専用の型
ソース コード ファイルが読み取り専用である型を含むプロジェクトの保存を試みた場合は、 [読み取り専用のファイルを保存] ダイアログ ボックスが表示され、新しい名前または新しい場所でファイルを保存するか、読み取り専用ファイルを上書きするかの選択肢が提示されます。 ファイルを上書きした場合、新しいコピーは読み取り専用でなくなります。
コード ファイルに構文エラーが含まれる場合、そのファイル内のコードを表示している図形は、構文エラーが修正されるまで一時的に読み取り専用になります。 この状態の図形は、"ソース コード ファイルに解析エラーが含まれています" というツールヒントを表示する赤いテキストと赤いアイコンで示されます。
別のプロジェクト ノードの下または参照されるアセンブリ ノードの下に存在する参照される型 (.NET 型など) は、クラス デザイナーのデザイン サーフェイスに読み取り専用として示されます。 開いたプロジェクトに存在するローカル型は読み書き可能であり、その図形は、クラス デザイナーのデザイン サーフェイスで読み書き可能として示されます。
インデクサーは、コードと [クラスの詳細] ウィンドウで読み書き可能ですが、インデクサー名は読み取り専用です。
[クラス デザイナー] ウィンドウまたは [クラスの詳細] ウィンドウを使用して部分メソッドを編集することはできません。部分メソッドの編集には、コード エディターを使用する必要があります。
[クラス デザイナー] ウィンドウまたは [クラスの詳細] ウィンドウを使用してネイティブ C++ コードを編集することはできません。ネイティブ C++ コードの編集には、コード エディターを使用する必要があります。