Skip to content

Commit

Permalink
commit translated contents
Browse files Browse the repository at this point in the history
  • Loading branch information
olprod committed Jul 31, 2018
1 parent 502c738 commit 35f496a
Showing 1 changed file with 15 additions and 15 deletions.
30 changes: 15 additions & 15 deletions docs/standard/design-guidelines/names-of-type-members.md
Original file line number Diff line number Diff line change
Expand Up @@ -27,7 +27,7 @@ ms.locfileid: "33575350"
## <a name="names-of-methods"></a>メソッドの名前
メソッドはアクションを実行する手段であるため、デザインのガイドラインでは、メソッド名を動詞または動詞句にする必要があります。 また、このガイドラインに従うと、名詞句または形容詞句であるプロパティ名および型名と、メソッド名を区別するためにも機能します。

**実行**: 動詞または動詞句のメソッド名を指定します。
**DO**: 動詞または動詞句のメソッド名を指定します。

```
public class String {
Expand All @@ -40,20 +40,20 @@ public class String {
## <a name="names-of-properties"></a>プロパティの名前
他のメンバーとは異なり、プロパティには名詞句または形容詞の名前を指定する必要があります。 つまり、プロパティはデータを参照するため、プロパティの名前にはデータが反映されます。 プロパティ名には、常に Pascal 形式が使用されます。

**実行**: 名詞、名詞句、または形容詞を使用してプロパティに名前を付けます。
**DO**: 名詞、名詞句、または形容詞を使用してプロパティに名前を付けます。

**X 禁止**: 次の例のように、"Get" メソッドの名前と一致するプロパティを使用しないでください。
**X DO NOT**: 次の例のように、"Get" メソッドの名前と一致するプロパティを使用しないでください。

`public string TextWriter { get {...} set {...} }`
`public string GetTextWriter(int value) { ... }`

通常、このパターンは、プロパティが実際にメソッドであることを示します。

**実行**: "List" または "Collection" が続く単数形の語句を使用する代わりに、コレクション内のアイテムを示す複数形の語句で、コレクション プロパティに名前を付けます。
**DO**: "List" または "Collection" が続く単数形の語句を使用する代わりに、コレクション内のアイテムを示す複数形の語句で、コレクション プロパティに名前を付けます。

**実行**: 肯定の語句 (`CantSeek` ではなく `CanSeek`) を使用して、ブール値のプロパティに名前を付けます。 また、ブール値のプロパティに "Is"、"Can"、または "Has" のプレフィックスを使用することもできますが、値を追加する場所のみです (オプション)。
**DO**: 肯定の語句 (`CantSeek` ではなく `CanSeek`) を使用して、ブール値のプロパティに名前を付けます。 また、ブール値のプロパティに "Is"、"Can"、または "Has" のプレフィックスを使用することもできますが、値を追加する場所のみです (オプション)。

**検討**: プロパティの型と同じ名前をプロパティに指定します。
**CONSIDER**: プロパティの型と同じ名前をプロパティに指定します。

たとえば、次のプロパティは、`Color` という名前の列挙値を適切に取得および設定するため、プロパティは `Color` という名前になります。

Expand All @@ -67,34 +67,34 @@ public class Control {
## <a name="names-of-events"></a>イベントの名前
イベントは常に、発生中のアクションまたは発生したアクションのいずれかのアクションを参照します。 そのため、メソッドと同様、イベントには動詞の名前が付けられ、イベントが発生した時刻を示すために動詞の時制が使用されます。

**実行**: 動詞または動詞句を使ってイベントに名前を付けます。
**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" サフィックスを使ってイベントの引数クラスに名前を付けます。

## <a name="names-of-fields"></a>フィールドの名前
フィールドの名前付けのガイドラインは、静的パブリック フィールドと保護されたフィールドを対象とします。 内部フィールドとプライベート フィールドは、ガイドラインの対象ではありません。また、パブリック インスタンス フィールドや保護されたインスタンス フィールドは、「[メンバーのデザインのガイドライン](../../../docs/standard/design-guidelines/member.md)」で許可されていません。

**実行**: フィールド名に Pascal 形式を使用します。
**DO**: フィールド名に Pascal 形式を使用します。

**実行**: 名詞、名詞句、または形容詞を使用してフィールドに名前を付けます。
**DO**: 名詞、名詞句、または形容詞を使用してフィールドに名前を付けます。

**X 禁止**: フィールド名にプレフィックスを使用しないでください。
**X DO NOT**: フィールド名にプレフィックスを使用しないでください。

たとえば、静的フィールドを示すために、"g_" や "s_" を使用しないでください。

Expand Down

0 comments on commit 35f496a

Please sign in to comment.