Skip to content

Commit ed97bb1

Browse files
BillWagnergewarren
andauthored
Replace "auto implemented" with "automatically" (#43211)
* Replace "auto implemented" with "automatically" Fixes #42252 In preparation for "field backed properties", make sure all our docs use the correct "automatically implemented" terminology. Because, field backed properties are kind of auto-implemented as well. I did update the VB docs as well, to keep them consistent. * fix the warnings * Apply suggestions from code review Co-authored-by: Genevieve Warren <[email protected]> --------- Co-authored-by: Genevieve Warren <[email protected]>
1 parent 56d4947 commit ed97bb1

File tree

46 files changed

+110
-110
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

46 files changed

+110
-110
lines changed

docs/csharp/advanced-topics/interop/walkthrough-office-programming.md

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -49,7 +49,7 @@ In **Solution Explorer**, right-click the **ThisAddIn.cs** file and then select
4949

5050
## Create a list of bank accounts
5151

52-
In **Solution Explorer**, right-click your project's name, select **Add**, and then select **Class**. Name the class Account.cs. Select **Add**. Replace the definition of the `Account` class with the following code. The class definitions use *auto-implemented properties*.
52+
In **Solution Explorer**, right-click your project's name, select **Add**, and then select **Class**. Name the class Account.cs. Select **Add**. Replace the definition of the `Account` class with the following code. The class definitions use *automatically implemented properties*.
5353

5454
:::code language="csharp" source="./snippets/OfficeWalkthrough/account.cs" id="AccountClass":::
5555

@@ -122,13 +122,13 @@ In Visual Studio, select **Clean Solution** on the **Build** menu. Otherwise, th
122122

123123
## See also
124124

125-
- [Auto-Implemented Properties (C#)](../../programming-guide/classes-and-structs/auto-implemented-properties.md)
126-
- [Object and Collection Initializers](../../programming-guide/classes-and-structs/object-and-collection-initializers.md)
125+
- [Automatically implemented properties (C#)](../../programming-guide/classes-and-structs/auto-implemented-properties.md)
126+
- [Object and collection initializers](../../programming-guide/classes-and-structs/object-and-collection-initializers.md)
127127
- [Visual Studio Tools for Office (VSTO)](/visualstudio/vsto/visual-studio-tools-for-office-runtime-overview)
128-
- [Named and Optional Arguments](../../programming-guide/classes-and-structs/named-and-optional-arguments.md)
128+
- [Named and optional arguments](../../programming-guide/classes-and-structs/named-and-optional-arguments.md)
129129
- [dynamic](../../language-reference/builtin-types/reference-types.md)
130-
- [Using Type dynamic](using-type-dynamic.md)
131-
- [Lambda Expressions (C#)](../../language-reference/operators/lambda-expressions.md)
132-
- [Walkthrough: Embedding Type Information from Microsoft Office Assemblies in Visual Studio](/previous-versions/visualstudio/visual-studio-2013/ee317478(v=vs.120))
133-
- [Walkthrough: Embedding Types from Managed Assemblies](../../../standard/assembly/embed-types-visual-studio.md)
134-
- [Walkthrough: Creating Your First VSTO Add-in for Excel](/visualstudio/vsto/walkthrough-creating-your-first-vsto-add-in-for-excel)
130+
- [Using type dynamic](using-type-dynamic.md)
131+
- [Lambda expressions (C#)](../../language-reference/operators/lambda-expressions.md)
132+
- [Walkthrough: Embedding type information from Microsoft Office assemblies in Visual Studio](/previous-versions/visualstudio/visual-studio-2013/ee317478(v=vs.120))
133+
- [Walkthrough: Embedding types from managed assemblies](../../../standard/assembly/embed-types-visual-studio.md)
134+
- [Walkthrough: Creating your first VSTO add-in for Excel](/visualstudio/vsto/walkthrough-creating-your-first-vsto-add-in-for-excel)

docs/csharp/advanced-topics/reflection-and-attributes/index.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -95,7 +95,7 @@ The list of possible `target` values is shown in the following table.
9595
| `return` | Return value of a method, property indexer, or `get` property accessor |
9696
| `type` | Struct, class, interface, enum, or delegate |
9797

98-
You would specify the `field` target value to apply an attribute to the backing field created for an [auto-implemented property](../../programming-guide/classes-and-structs/properties.md).
98+
You would specify the `field` target value to apply an attribute to the backing field created for an [automatically implemented property](../../programming-guide/classes-and-structs/properties.md).
9999

100100
The following example shows how to apply attributes to assemblies and modules. For more information, see [Common Attributes (C#)](../../language-reference/attributes/global.md).
101101

docs/csharp/fundamentals/types/interfaces.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ helpviewer_keywords:
88
---
99
# Interfaces - define behavior for multiple types
1010

11-
An interface contains definitions for a group of related functionalities that a non-abstract [`class`](../../language-reference/keywords/class.md) or a [`struct`](../../language-reference/builtin-types/struct.md) must implement. An interface may define `static` methods, which must have an implementation. An interface may define a default implementation for members. An interface may not declare instance data such as fields, auto-implemented properties, or property-like events.
11+
An interface contains definitions for a group of related functionalities that a non-abstract [`class`](../../language-reference/keywords/class.md) or a [`struct`](../../language-reference/builtin-types/struct.md) must implement. An interface may define `static` methods, which must have an implementation. An interface may define a default implementation for members. An interface may not declare instance data such as fields, automatically implemented properties, or property-like events.
1212

1313
By using interfaces, you can, for example, include behavior from multiple sources in a class. That capability is important in C# because the language doesn't support multiple inheritance of classes. In addition, you must use an interface if you want to simulate inheritance for structs, because they can't actually inherit from another struct or class.
1414

docs/csharp/how-to/index.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -22,7 +22,7 @@ There are several tips and tricks that are common C# developer practices:
2222

2323
You create classes, records, and structs to implement your program. These techniques are commonly used when writing classes, records, or structs.
2424

25-
- [Declare auto implemented properties](../programming-guide/classes-and-structs/how-to-implement-a-lightweight-class-with-auto-implemented-properties.md).
25+
- [Declare automatically implemented properties](../programming-guide/classes-and-structs/how-to-implement-a-lightweight-class-with-auto-implemented-properties.md).
2626
- [Declare and use read/write properties](../programming-guide/classes-and-structs/how-to-declare-and-use-read-write-properties.md).
2727
- [Define constants](../programming-guide/classes-and-structs/how-to-define-constants.md).
2828
- [Override the `ToString` method to provide string output](../programming-guide/classes-and-structs/how-to-override-the-tostring-method.md).

docs/csharp/language-reference/attributes/general.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -120,7 +120,7 @@ If <xref:System.AttributeUsageAttribute.Inherited> is `false`, then derived clas
120120

121121
In this case, `NonInheritedAttribute` isn't applied to `DClass` via inheritance.
122122

123-
You can also use these keywords to specify where an attribute should be applied. For example, you can use the `field:` specifier to add an attribute to the backing field of an [autoimplemented property](../../programming-guide/classes-and-structs/properties.md#auto-implemented-properties). Or you can use the `field:`, `property:` or `param:` specifier to apply an attribute to any of the elements generated from a positional record. For an example, see [Positional syntax for property definition](../builtin-types/record.md#positional-syntax-for-property-definition).
123+
You can also use these keywords to specify where an attribute should be applied. For example, you can use the `field:` specifier to add an attribute to the backing field of an [automatically implemented property](../../programming-guide/classes-and-structs/properties.md#automatically-implemented-properties). Or you can use the `field:`, `property:` or `param:` specifier to apply an attribute to any of the elements generated from a positional record. For an example, see [Positional syntax for property definition](../builtin-types/record.md#positional-syntax-for-property-definition).
124124

125125
## `AsyncMethodBuilder` attribute
126126

docs/csharp/language-reference/builtin-types/struct.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -28,7 +28,7 @@ Because structure types have value semantics, we recommend you define *immutable
2828
You use the `readonly` modifier to declare that a structure type is immutable. All data members of a `readonly` struct must be read-only as follows:
2929

3030
- Any field declaration must have the [`readonly` modifier](../keywords/readonly.md)
31-
- Any property, including auto-implemented ones, must be read-only or [`init` only](../keywords/init.md). Note that init-only setters are only available from [C# version 9 onwards](../../whats-new/csharp-version-history.md).
31+
- Any property, including automatically implemented ones, must be read-only or [`init` only](../keywords/init.md). Note that init-only setters are only available from [C# version 9 onwards](../../whats-new/csharp-version-history.md).
3232

3333
That guarantees that no member of a `readonly` struct modifies the state of the struct. That means that other instance members except constructors are implicitly [`readonly`](#readonly-instance-members).
3434

@@ -62,7 +62,7 @@ Typically, you apply the `readonly` modifier to the following kinds of instance
6262
If you need to apply the `readonly` modifier to both accessors of a property or indexer, apply it in the declaration of the property or indexer.
6363

6464
> [!NOTE]
65-
> The compiler declares a `get` accessor of an [auto-implemented property](../../programming-guide/classes-and-structs/auto-implemented-properties.md) as `readonly`, regardless of presence of the `readonly` modifier in a property declaration.
65+
> The compiler declares a `get` accessor of an [automatically implemented property](../../programming-guide/classes-and-structs/auto-implemented-properties.md) as `readonly`, regardless of presence of the `readonly` modifier in a property declaration.
6666
6767
You may apply the `readonly` modifier to a property or indexer with an `init` accessor:
6868

docs/csharp/language-reference/compiler-messages/cs0840.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ ms.assetid: f307083f-8d86-4142-a9fd-b735910687b2
1212

1313
'Property name' must declare a body because it is not marked abstract or extern. Automatically implemented properties must define both get and set accessors.
1414

15-
Unless a regular property is marked as `abstract` or `extern`, or is a member of a `partial` type, it must supply a body. Auto-implemented properties do not provide accessor bodies, but they must specify both accessors. To create a read-only auto-implemented property, make the set accessor `private`.
15+
Unless a regular property is marked as `abstract` or `extern`, or is a member of a `partial` type, it must supply a body. Automatically implemented properties do not provide accessor bodies, but they must specify both accessors. To create a read-only automatically implemented property, make the set accessor `private`.
1616

1717
## To correct this error
1818

@@ -39,4 +39,4 @@ class Test
3939

4040
## See also
4141

42-
- [Auto-Implemented Properties](../../programming-guide/classes-and-structs/auto-implemented-properties.md)
42+
- [Automatically implemented properties](../../programming-guide/classes-and-structs/auto-implemented-properties.md)

docs/csharp/language-reference/compiler-messages/cs8145.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@ helpviewer_keywords:
1111

1212
Auto-implemented properties cannot return by reference
1313

14-
Auto-implemented properties are not guaranteed to have a member or variable that can be referenced and thus do not support return by reference.
14+
Automatically implemented properties are not guaranteed to have a member or variable that can be referenced and thus do not support return by reference.
1515

1616
## Example
1717

docs/csharp/language-reference/compiler-messages/partial-declarations.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -229,4 +229,4 @@ The following warning indicates a signature difference in the declaring and impl
229229

230230
- **CS9256**: *Partial property declarations have signature differences.*
231231

232-
A partial property or indexer must have both a *declaring declaration* and an *implementing declaration*. The signatures for both declarations must match. Because the *declaring declaration* uses the same syntax as an auto-implemented property, the *implementing declaration* can't be an auto-implemented property. The accessors must have bodies.
232+
A partial property or indexer must have both a *declaring declaration* and an *implementing declaration*. The signatures for both declarations must match. Because the *declaring declaration* uses the same syntax as an automatically implemented property, the *implementing declaration* can't be an automatically implemented property. The accessors must have bodies.

docs/csharp/language-reference/compiler-messages/ref-struct-errors.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -56,7 +56,7 @@ ms.date: 07/30/2024
5656

5757
A [`ref struct`](../builtin-types/ref-struct.md) type can include `ref` fields. Other types aren't allowed `ref` fields. The compiler enforces restrictions on the declarations and use of `ref struct` types to enforce ref safety rules on instances of any `ref struct` type:
5858

59-
- Only `ref struct` types can contain auto-implemented `ref` properties.
59+
- Only `ref struct` types can contain automatically implemented `ref` properties.
6060
- Only `ref struct` types or `ref` variables can have the `scoped` modifier.
6161
- A `ref` field can be declared only in a `ref struct` type.
6262
- A `ref` field can't refer to a `ref struct` type/

0 commit comments

Comments
 (0)