From fa31654084b989dd19e71f32fe0f6c8df9d2322a Mon Sep 17 00:00:00 2001 From: olprod Date: Tue, 31 Jul 2018 18:08:38 +0000 Subject: [PATCH] commit translated contents --- .../names-of-type-members.md | 38 +++++++++---------- 1 file changed, 19 insertions(+), 19 deletions(-) diff --git a/docs/standard/design-guidelines/names-of-type-members.md b/docs/standard/design-guidelines/names-of-type-members.md index 9846b898ab5..f9e738f5981 100644 --- a/docs/standard/design-guidelines/names-of-type-members.md +++ b/docs/standard/design-guidelines/names-of-type-members.md @@ -15,10 +15,10 @@ ms.assetid: af5a0903-36af-4c2a-b848-cf959affeaa5 author: rpetrusha ms.author: ronpet ms.openlocfilehash: 25fe93b63c518f54ee72300f26dfcb3f3ad21d76 -ms.sourcegitcommit: 70c76a12449439bac0f7a359866be5a0311ce960 -ms.translationtype: HT +ms.sourcegitcommit: b6baf91310f6867223f0f32d596b451592b917b5 +ms.translationtype: MT ms.contentlocale: ja-JP -ms.lasthandoff: 07/26/2018 +ms.lasthandoff: 07/31/2018 ms.locfileid: "33575350" --- # 型のメンバーの名前 @@ -27,7 +27,7 @@ ms.locfileid: "33575350" ## メソッドの名前 メソッドはアクションを実行する手段であるため、デザインのガイドラインでは、メソッド名を動詞または動詞句にする必要があります。 また、このガイドラインに従うと、名詞句または形容詞句であるプロパティ名および型名と、メソッド名を区別するためにも機能します。 - **✓ DO**: 動詞または動詞句のメソッド名を指定します。 + **✓ 推奨** 動詞または動詞句は、メソッドの名前を指定します。 ``` public class String { @@ -40,20 +40,20 @@ public class String { ## プロパティの名前 他のメンバーとは異なり、プロパティには名詞句または形容詞の名前を指定する必要があります。 つまり、プロパティはデータを参照するため、プロパティの名前にはデータが反映されます。 プロパティ名には、常に Pascal 形式が使用されます。 - **✓ DO**: 名詞、名詞句、または形容詞を使用してプロパティに名前を付けます。 + **✓ 推奨** 名詞、名詞句、または形容詞を使用してプロパティの名前を付けます。 - **X DO NOT**: 次の例のように、"Get" メソッドの名前と一致するプロパティを使用しないでください。 + **X 非推奨** 次の例のように、"Get"メソッドの名前に一致するプロパティがあります。 `public string TextWriter { get {...} set {...} }` `public string GetTextWriter(int value) { ... }` 通常、このパターンは、プロパティが実際にメソッドであることを示します。 - **✓ DO**: "List" または "Collection" が続く単数形の語句を使用する代わりに、コレクション内のアイテムを示す複数形の語句で、コレクション プロパティに名前を付けます。 + **✓ 推奨** 後に"List"または"Collection"単数形の語句を使用する代わりに、コレクション内の項目を記述する複数形の語句でコレクションのプロパティの名前を付けます - **✓ DO**: 肯定の語句 (`CantSeek` ではなく `CanSeek`) を使用して、ブール値のプロパティに名前を付けます。 また、ブール値のプロパティに "Is"、"Can"、または "Has" のプレフィックスを使用することもできますが、値を追加する場所のみです (オプション)。 + **✓ 推奨** 肯定の語句でブール型プロパティの名前 (`CanSeek`の代わりに`CantSeek`)。 必要に応じて、ブールプロパティの先頭に "Is"、 "Can"、または "Has"を追加することもできますが、値を追加する場合に限定します。 - **✓ CONSIDER**: プロパティの型と同じ名前をプロパティに指定します。 + **✓ 要検討** プロパティの型と同じ名前を提供します。 たとえば、次のプロパティは、`Color` という名前の列挙値を適切に取得および設定するため、プロパティは `Color` という名前になります。 @@ -67,34 +67,34 @@ public class Control { ## イベントの名前 イベントは常に、発生中のアクションまたは発生したアクションのいずれかのアクションを参照します。 そのため、メソッドと同様、イベントには動詞の名前が付けられ、イベントが発生した時刻を示すために動詞の時制が使用されます。 - **✓ DO**: 動詞または動詞句を使ってイベントに名前を付けます。 + **✓ 推奨** 動詞または動詞句を持つイベントの名前を付けます。 例として、`Clicked`、`Painting`、`DroppedDown` などがあります。 - **✓ DO**: 現在形や過去形を使って、イベント名に前と後の概念を指定します。 + **✓ 推奨** 現在および過去時制を使用して、前後の概念でイベント名を提供します。 たとえば、ウィンドウを閉じる前に発生するクローズ イベントは `Closing` と呼ばれ、ウィンドウを閉じた後に発生するクローズ イベントは `Closed` と呼ばれます。 - **X DO NOT**: プリイベントとポストイベントを示すために、"Before" や "After" の接頭辞または接尾辞を使用しないでください。 前述のように、現在形と過去形を使用します。 + **X 非推奨** プレイベントとポストイベントを示す "Before" または "After"を接頭や接尾に使用しないでください。 前述の通り、現在と過去の時制を使用します。 前述のように、現在形と過去形を使用します。 - **✓ DO**: 次の例に示すように、イベント ハンドラー (イベントの型として使用されるデリゲート) に "EventHandler" サフィックスを使って名前を付けます。 + **✓ 推奨** 次の例に示すように"EventHandler"サフィックスを持つイベント ハンドラー (デリゲートがイベントの種類として使用) の名前をつけます。 `public delegate void ClickedEventHandler(object sender, ClickedEventArgs e);` - **✓ DO**: イベント ハンドラーに `sender` と `e` という名前の 2 つのパラメーターを使用します。 + **✓ 推奨** イベント ハンドラーにおいては`sender`と`e`という 2 つのパラメーターを使用します。 sender パラメーターは、イベントを発生させたオブジェクトを表します。 より具体的な型を使用できる場合も、通常、sender パラメーターの型は `object` になります。 - **✓ DO**: "EventArgs" サフィックスを使ってイベントの引数クラスに名前を付けます。 + **✓ 推奨** イベント引数クラス"EventArgs"サフィックスを持つ名前を付けます。 ## フィールドの名前 フィールドの名前付けのガイドラインは、静的パブリック フィールドと保護されたフィールドを対象とします。 内部フィールドとプライベート フィールドは、ガイドラインの対象ではありません。また、パブリック インスタンス フィールドや保護されたインスタンス フィールドは、「[メンバーのデザインのガイドライン](../../../docs/standard/design-guidelines/member.md)」で許可されていません。 - **✓ DO**: フィールド名に Pascal 形式を使用します。 + **✓ 推奨** フィールドの名前に PascalCasing を使用します。 - **✓ DO**: 名詞、名詞句、または形容詞を使用してフィールドに名前を付けます。 + **✓ 推奨** 名詞、名詞句、または形容詞を使用してフィールドの名前を付けます。 - **X DO NOT**: フィールド名にプレフィックスを使用しないでください。 + **X 非推奨** フィールド名に接頭語を使用しないでください。 たとえば、静的フィールドを示すために、"g_" や "s_" を使用しないでください。 @@ -102,6 +102,6 @@ public class Control { *2008 年 10 月 22 日に Microsoft Windows Development シリーズの一部として、Addison-Wesley Professional によって発行された、Krzysztof Cwalina および Brad Abrams による「[Framework Design Guidelines: Conventions, Idioms, and Patterns for Reusable .NET Libraries, 2nd Edition](https://www.informit.com/store/framework-design-guidelines-conventions-idioms-and-9780321545619)」 (フレームワーク デザイン ガイドライン: 再利用可能な .NET ライブラリの規則、用法、パターン、第 2 版) から Pearson Education, Inc. の許可を得て再印刷されています。* -## 参照 +## 関連項目 [フレームワーク デザインのガイドライン](../../../docs/standard/design-guidelines/index.md) [名前付けのガイドライン](../../../docs/standard/design-guidelines/naming-guidelines.md)