From 830f810497707f53c7b8e5d31d4037d9f4a1e07e Mon Sep 17 00:00:00 2001 From: olprod Date: Wed, 1 Aug 2018 06:30:43 +0000 Subject: [PATCH] commit translated contents --- .../names-of-type-members.md | 30 +++++++++---------- 1 file changed, 15 insertions(+), 15 deletions(-) diff --git a/docs/standard/design-guidelines/names-of-type-members.md b/docs/standard/design-guidelines/names-of-type-members.md index f9e738f5981..e240b0f7c01 100644 --- a/docs/standard/design-guidelines/names-of-type-members.md +++ b/docs/standard/design-guidelines/names-of-type-members.md @@ -27,7 +27,7 @@ ms.locfileid: "33575350" ## メソッドの名前 メソッドはアクションを実行する手段であるため、デザインのガイドラインでは、メソッド名を動詞または動詞句にする必要があります。 また、このガイドラインに従うと、名詞句または形容詞句であるプロパティ名および型名と、メソッド名を区別するためにも機能します。 - **✓ 推奨** 動詞または動詞句は、メソッドの名前を指定します。 + **✓ DO** 動詞または動詞句は、メソッドの名前を指定します。 ``` public class String { @@ -40,20 +40,20 @@ public class String { ## プロパティの名前 他のメンバーとは異なり、プロパティには名詞句または形容詞の名前を指定する必要があります。 つまり、プロパティはデータを参照するため、プロパティの名前にはデータが反映されます。 プロパティ名には、常に Pascal 形式が使用されます。 - **✓ 推奨** 名詞、名詞句、または形容詞を使用してプロパティの名前を付けます。 + **✓ DO** 名詞、名詞句、または形容詞を使用してプロパティの名前を付けます。 - **X 非推奨** 次の例のように、"Get"メソッドの名前に一致するプロパティがあります。 + **X DO NOT** 次の例のように、"Get"メソッドの名前に一致するプロパティがあります。 `public string TextWriter { get {...} set {...} }` `public string GetTextWriter(int value) { ... }` 通常、このパターンは、プロパティが実際にメソッドであることを示します。 - **✓ 推奨** 後に"List"または"Collection"単数形の語句を使用する代わりに、コレクション内の項目を記述する複数形の語句でコレクションのプロパティの名前を付けます + **✓ DO** 後に"List"または"Collection"単数形の語句を使用する代わりに、コレクション内の項目を記述する複数形の語句でコレクションのプロパティの名前を付けます - **✓ 推奨** 肯定の語句でブール型プロパティの名前 (`CanSeek`の代わりに`CantSeek`)。 必要に応じて、ブールプロパティの先頭に "Is"、 "Can"、または "Has"を追加することもできますが、値を追加する場合に限定します。 + **✓ DO** 肯定の語句でブール型プロパティの名前 (`CanSeek`の代わりに`CantSeek`)。 必要に応じて、ブールプロパティの先頭に "Is"、 "Can"、または "Has"を追加することもできますが、値を追加する場合に限定します。 - **✓ 要検討** プロパティの型と同じ名前を提供します。 + **✓ CONSIDER** プロパティの型と同じ名前を提供します。 たとえば、次のプロパティは、`Color` という名前の列挙値を適切に取得および設定するため、プロパティは `Color` という名前になります。 @@ -67,34 +67,34 @@ public class Control { ## イベントの名前 イベントは常に、発生中のアクションまたは発生したアクションのいずれかのアクションを参照します。 そのため、メソッドと同様、イベントには動詞の名前が付けられ、イベントが発生した時刻を示すために動詞の時制が使用されます。 - **✓ 推奨** 動詞または動詞句を持つイベントの名前を付けます。 + **✓ DO** 動詞または動詞句を持つイベントの名前を付けます。 例として、`Clicked`、`Painting`、`DroppedDown` などがあります。 - **✓ 推奨** 現在および過去時制を使用して、前後の概念でイベント名を提供します。 + **✓ DO** 現在および過去時制を使用して、前後の概念でイベント名を提供します。 たとえば、ウィンドウを閉じる前に発生するクローズ イベントは `Closing` と呼ばれ、ウィンドウを閉じた後に発生するクローズ イベントは `Closed` と呼ばれます。 - **X 非推奨** プレイベントとポストイベントを示す "Before" または "After"を接頭や接尾に使用しないでください。 前述の通り、現在と過去の時制を使用します。 前述のように、現在形と過去形を使用します。 + **X DO NOT** プレイベントとポストイベントを示す "Before" または "After"を接頭や接尾に使用しないでください。 前述の通り、現在と過去の時制を使用します。 前述のように、現在形と過去形を使用します。 - **✓ 推奨** 次の例に示すように"EventHandler"サフィックスを持つイベント ハンドラー (デリゲートがイベントの種類として使用) の名前をつけます。 + **✓ DO** 次の例に示すように"EventHandler"サフィックスを持つイベント ハンドラー (デリゲートがイベントの種類として使用) の名前をつけます。 `public delegate void ClickedEventHandler(object sender, ClickedEventArgs e);` - **✓ 推奨** イベント ハンドラーにおいては`sender`と`e`という 2 つのパラメーターを使用します。 + **✓ DO** イベント ハンドラーにおいては`sender`と`e`という 2 つのパラメーターを使用します。 sender パラメーターは、イベントを発生させたオブジェクトを表します。 より具体的な型を使用できる場合も、通常、sender パラメーターの型は `object` になります。 - **✓ 推奨** イベント引数クラス"EventArgs"サフィックスを持つ名前を付けます。 + **✓ DO** イベント引数クラス"EventArgs"サフィックスを持つ名前を付けます。 ## フィールドの名前 フィールドの名前付けのガイドラインは、静的パブリック フィールドと保護されたフィールドを対象とします。 内部フィールドとプライベート フィールドは、ガイドラインの対象ではありません。また、パブリック インスタンス フィールドや保護されたインスタンス フィールドは、「[メンバーのデザインのガイドライン](../../../docs/standard/design-guidelines/member.md)」で許可されていません。 - **✓ 推奨** フィールドの名前に PascalCasing を使用します。 + **✓ DO** フィールドの名前に PascalCasing を使用します。 - **✓ 推奨** 名詞、名詞句、または形容詞を使用してフィールドの名前を付けます。 + **✓ DO** 名詞、名詞句、または形容詞を使用してフィールドの名前を付けます。 - **X 非推奨** フィールド名に接頭語を使用しないでください。 + **X DO NOT** フィールド名に接頭語を使用しないでください。 たとえば、静的フィールドを示すために、"g_" や "s_" を使用しないでください。