From 27a9aece52d84622e62e8245cc0d2f4b39c4255e Mon Sep 17 00:00:00 2001 From: Bill Wagner Date: Sun, 17 Sep 2017 16:22:03 -0400 Subject: [PATCH 01/13] fix constructor remarks formatting. (#3141) * fix constructor remarks formatting. * another instance * Update String.xml * Update String.xml --- xml/System/String.xml | 26 +++++++++++++------------- 1 file changed, 13 insertions(+), 13 deletions(-) diff --git a/xml/System/String.xml b/xml/System/String.xml index c8a8295c19d83..e17709bb2615f 100644 --- a/xml/System/String.xml +++ b/xml/System/String.xml @@ -567,36 +567,36 @@ For additional guidance on choosing an overload, see [Which method do I call?](#Tasks) - `String(Char[]` `value` `)` + `String(Char[] value)` Initializes the new instance to the value indicated by an array of Unicode characters. This constructor copies Unicode characters([example](#Ctor2_Example)). - `String(Char[]` `value` `, Int32` `startIndex` `, Int32` `length` `)` + `String(Char[] value, Int32 startIndex, Int32 length)` Initializes the new instance to the value indicated by an array of Unicode characters, a starting character position within that array, and a length ([example](#Ctor3_Example)). - `String(Char` `c` `, Int32` `count` `)` + `String(Char c, Int32 count)` Initializes the new instance to the value indicated by a specified Unicode character repeated a specified number of times ([example](#Ctor3_Example)). - `String(char*` `value` `)` + `String(char* value)` **(Not CLS-compliant)** Initializes the new instance to the value indicated by a pointer to an array of Unicode characters that is terminated by a null character (U+0000 or '\0'). ([example](#Ctor4_Example)). Permission: , requires full trust for the immediate caller. This member cannot be used by partially trusted or transparent code. - `String(char*` `value` `, Int32` `startIndex` `, Int32` `length` `)` + `String(char* value, Int32 startIndex, Int32 length)` **(Not CLS-compliant)** Initializes the new instance to the value indicated by a pointer to an array of Unicode characters, a starting character position within that array, and a length. The constructor copies the Unicode characters from `value` starting at index `startIndex` and ending at index `startIndex` + `length` – 1 ([example](#Ctor5_Example)). Permission: , requires full trust for the immediate caller. This member cannot be used by partially trusted or transparent code. - `String(SByte*` `value` `)` + `String(SByte* value)` **(Not CLS-compliant)** Initializes the new instance to the value indicated by a pointer to an array of 8-bit signed integers. The array is assumed to represent a string encoded using the current system code page (that is, the encoding specified by ). The constructor processes characters from `value` starting from the location specified by the pointer until a null character (0x00) is reached ([example](#Ctor6_Example)). Permission: , requires full trust for the immediate caller. This member cannot be used by partially trusted or transparent code. - `String(SByte*` `value` `, Int32` `startIndex` `, Int32` `length` `)` + `String(SByte* value, Int32 startIndex, Int32 length)` **(Not CLS-compliant)** Initializes the new instance to the value indicated by a pointer to an array of 8-bit signed integers, a starting position within that array, and a length. The array is assumed to represent a string encoded using the current system code page (that is, the encoding specified by ). The constructor processes characters from value starting at `startIndex` and ending at `startIndex` + `length` – 1 ([example](#Ctor6_Example)). Permission: , requires full trust for the immediate caller. This member cannot be used by partially trusted or transparent code. - `String(SByte*` `value` `, Int32` `startIndex` `, Int32` `length` `, Encoding` `enc` `)` + `String(SByte* value, Int32 startIndex, Int32 length, Encoding enc)` **(Not CLS-compliant)** Initializes the new instance to the value indicated by a pointer to an array of 8-bit signed integers, a starting position within that array, a length, and an object. Permission: , requires full trust for the immediate caller. This member cannot be used by partially trusted or transparent code. @@ -4324,19 +4324,19 @@ ## Overloaded method syntax For additional guidance on choosing an overload, see [Which method do I call?](#FTaskList) - `String String.Format(String` `format` `, Object` `arg0` `)` + `String String.Format(String format, Object arg0)` Replaces the format items with the string representation of a specified object ([example](#Format1_Example)). - `String String.Format(String` `format` `, Object` `arg0` `, Object` `arg1` `)` + `String String.Format(String format, Object arg0, Object arg1)` Replaces the format items with the string representation of two specified objects ([example](#Format2_Example)). - `String String.Format(String` `format` `, Object` `arg0` `, Object` `arg1` `, Object` `arg2` `)` + `String String.Format(String format, Object arg0, Object arg1, Object arg2)` Replaces the format items with the string representation of three specified objects ([example](#Format3_Example)). - `String String.Format(String` `format` `, params Object[]` `args` `)` + `String String.Format(String format, params Object[] args)` Replaces the format items with the string representations of corresponding objects in a specified array ([example](#Format4_Example)). - `String String.Format(IFormatProvider` `provider` `, String` `format` `, params Object[]` `args` `)` + `String String.Format(IFormatProvider provider, String format, params Object[] args)` Replaces the format items with the string representation of corresponding objects in a specified array, and uses the specified culture-specific formatting information ([example](#Format5_Example)) or custom formatting information ([example](#Format6_Example)). From cd7301100f44ce3a9cf4e8a342dbf4aaacb373bb Mon Sep 17 00:00:00 2001 From: Muhammad Yaseen Date: Mon, 18 Sep 2017 04:58:59 +0300 Subject: [PATCH 02/13] | didn't render to `|` properly (#3162) --- docs/standard/design-guidelines/operator-overloads.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/standard/design-guidelines/operator-overloads.md b/docs/standard/design-guidelines/operator-overloads.md index 0ec07a8612b8d..c2da9cfc49130 100644 --- a/docs/standard/design-guidelines/operator-overloads.md +++ b/docs/standard/design-guidelines/operator-overloads.md @@ -64,9 +64,9 @@ Operator overloads allow framework types to appear as if they were built-in lang |`%`|`op_Modulus`|`Mod or Remainder`| |`^`|`op_ExclusiveOr`|`Xor`| |`& (binary)`|`op_BitwiseAnd`|`BitwiseAnd`| -|`|`|`op_BitwiseOr`|`BitwiseOr`| +|||`op_BitwiseOr`|`BitwiseOr`| |`&&`|`op_LogicalAnd`|`And`| -|`||`|`op_LogicalOr`|`Or`| +||||`op_LogicalOr`|`Or`| |`=`|`op_Assign`|`Assign`| |`<<`|`op_LeftShift`|`LeftShift`| |`>>`|`op_RightShift`|`RightShift`| @@ -85,7 +85,7 @@ Operator overloads allow framework types to appear as if they were built-in lang |`%=`|`op_ModulusAssignment`|`Mod`| |`+=`|`op_AdditionAssignment`|`Add`| |`&=`|`op_BitwiseAndAssignment`|`BitwiseAnd`| -|`|=`|`op_BitwiseOrAssignment`|`BitwiseOr`| +||=|`op_BitwiseOrAssignment`|`BitwiseOr`| |`,`|`op_Comma`|`Comma`| |`/=`|`op_DivisionAssignment`|`Divide`| |`--`|`op_Decrement`|`Decrement`| From 7c833bdbdc13d2e6c57aa52a24443b0dfa7bb523 Mon Sep 17 00:00:00 2001 From: Vasily Date: Mon, 18 Sep 2017 06:27:43 +0300 Subject: [PATCH 03/13] Added missing space between two words (#3161) --- .../programming-guide/language-features/events/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/visual-basic/programming-guide/language-features/events/index.md b/docs/visual-basic/programming-guide/language-features/events/index.md index 30bcbbc2bf1eb..1f2d017a44ca6 100644 --- a/docs/visual-basic/programming-guide/language-features/events/index.md +++ b/docs/visual-basic/programming-guide/language-features/events/index.md @@ -77,7 +77,7 @@ While you might visualize a [!INCLUDE[vsprvs](~/includes/vsprvs-md.md)] project - You cannot use a `WithEvents` variable as an object variable. That is, you cannot declare it as `Object`—you must specify the class name when you declare the variable. -- Because shared eventsare not tied to class instances, you cannot use `WithEvents` to declaratively handle shared events. Similarly, you cannot use `WithEvents` or `Handles` to handle events from a `Structure`. In both cases, you can use the `AddHandler` statement to handle those events. +- Because shared events are not tied to class instances, you cannot use `WithEvents` to declaratively handle shared events. Similarly, you cannot use `WithEvents` or `Handles` to handle events from a `Structure`. In both cases, you can use the `AddHandler` statement to handle those events. - You cannot create arrays of `WithEvents` variables. From ddbd44f84e9e3d69aea9f70bd53a3d7662d8c369 Mon Sep 17 00:00:00 2001 From: Caro Caserio Date: Mon, 18 Sep 2017 13:30:23 -0300 Subject: [PATCH 04/13] M10669: Possible typo mistake: 'SC1721' (#3167) @wiwagn, It seems that 'SC1721' is a typo of 'CS1721'. Could you help to review this and reply, please? Many thanks in advance! --- docs/csharp/language-reference/compiler-messages/cs1721.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/csharp/language-reference/compiler-messages/cs1721.md b/docs/csharp/language-reference/compiler-messages/cs1721.md index 4056c645a3edd..8687e5247c446 100644 --- a/docs/csharp/language-reference/compiler-messages/cs1721.md +++ b/docs/csharp/language-reference/compiler-messages/cs1721.md @@ -36,7 +36,7 @@ Class 'class' cannot have multiple base classes: 'class_1' and 'class_2' The most common cause of this error message is attempting to use multiple inheritance. A class in C# may only inherit directly from one class. However, a class can implement any number of interfaces. ## Example - The following example shows one way in which SC1721 is generated, and then shows two possible ways to avoid the error. + The following example shows one way in which CS1721 is generated, and then shows two possible ways to avoid the error. ```csharp // CS1721.cs From 0a4dfe683140ee7f2584fc4927469a2e6937fa38 Mon Sep 17 00:00:00 2001 From: Hans De Mulder Date: Mon, 18 Sep 2017 18:32:51 +0200 Subject: [PATCH 05/13] Update sample code for documentation VB.NET "what's new : language features : Tuples" (#3166) * what's new Tuples : sample use InvariantCulture * vb tuple example fix new language feature sample --- .../language-features/data-types/tuple-returns.vb | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/samples/snippets/visualbasic/programming-guide/language-features/data-types/tuple-returns.vb b/samples/snippets/visualbasic/programming-guide/language-features/data-types/tuple-returns.vb index df4d5328da03d..4e5406a9d27ce 100644 --- a/samples/snippets/visualbasic/programming-guide/language-features/data-types/tuple-returns.vb +++ b/samples/snippets/visualbasic/programming-guide/language-features/data-types/tuple-returns.vb @@ -4,7 +4,7 @@ Imports System.Globalization Public Module NumericLibrary Public Function ParseInteger(value As String) As (Success As Boolean, Number As Int32) Dim number As Integer - Return (Int32.TryParse(value, NumberStyles.Any, Nothing, number), number) + Return (Int32.TryParse(value, NumberStyles.Any, CultureInfo.InvariantCulture, number), number) End Function End Module ' @@ -29,9 +29,9 @@ Module Module1 Private Sub MethodCallWithTuple() ' - Dim number As String = "123,456" - Dim result = ParseInteger(number) - Console.WriteLine($"{IIf(result.Success, $"Success: {number:N0}", "Failure")}") + Dim numericString As String = "123,456" + Dim result = ParseInteger(numericString) + Console.WriteLine($"{IIf(result.Success, $"Success: {result.Number:N0}", "Failure")}") Console.ReadLine() ' Output: Success: 123,456 ' From b1d0fe8e42ec5846e812c118d7c095954c990fd6 Mon Sep 17 00:00:00 2001 From: Maira Wenzel Date: Mon, 18 Sep 2017 11:34:33 -0700 Subject: [PATCH 06/13] fixed broken link (#3169) --- docs/standard/collections/index.md | 12 +----------- 1 file changed, 1 insertion(+), 11 deletions(-) diff --git a/docs/standard/collections/index.md b/docs/standard/collections/index.md index 7941536375151..d864861425ea7 100644 --- a/docs/standard/collections/index.md +++ b/docs/standard/collections/index.md @@ -1,12 +1,8 @@ --- title: "Collections and Data Structures" -ms.custom: "" ms.date: "03/30/2017" ms.prod: ".net" -ms.reviewer: "" -ms.suite: "" ms.technology: dotnet-standard -ms.tgt_pltfrm: "" ms.topic: "article" helpviewer_keywords: - "grouping data in collections" @@ -91,15 +87,9 @@ Similar data can often be handled more efficiently when stored and manipulated a ## Reference - - - - - - - System.Collections.Immutable + From fc8ef624767298101eae9250211e1e0a4cf89597 Mon Sep 17 00:00:00 2001 From: Maira Wenzel Date: Tue, 19 Sep 2017 12:23:04 -0700 Subject: [PATCH 07/13] fixed pipes in tables (#3163) --- .../concepts/linq/linq-to-xml-for-xpath-users.md | 7 +------ .../framework/tools/ngen-exe-native-image-generator.md | 2 +- ...ervice-model-configuration-tool-comsvcconfig-exe.md | 10 +++++----- .../concepts/linq/linq-to-xml-for-xpath-users.md | 8 ++------ 4 files changed, 9 insertions(+), 18 deletions(-) diff --git a/docs/csharp/programming-guide/concepts/linq/linq-to-xml-for-xpath-users.md b/docs/csharp/programming-guide/concepts/linq/linq-to-xml-for-xpath-users.md index 81c768729b188..4d4513d4e6381 100644 --- a/docs/csharp/programming-guide/concepts/linq/linq-to-xml-for-xpath-users.md +++ b/docs/csharp/programming-guide/concepts/linq/linq-to-xml-for-xpath-users.md @@ -1,13 +1,9 @@ --- title: "LINQ to XML for XPath Users (C#)" -ms.custom: "" ms.date: "2015-07-20" ms.prod: .net -ms.reviewer: "" -ms.suite: "" ms.technology: - "devlang-csharp" - ms.topic: "article" dev_langs: - "CSharp" @@ -15,7 +11,6 @@ ms.assetid: 91774511-1dca-4f06-ac0b-913746f104fe caps.latest.revision: 3 author: "BillWagner" ms.author: "wiwagn" - --- # LINQ to XML for XPath Users (C#) This set of topics show a number of XPath expressions and their [!INCLUDE[sqltecxlinq](~/includes/sqltecxlinq-md.md)] equivalents. @@ -36,7 +31,7 @@ This set of topics show a number of XPath expressions and their [!INCLUDE[sqltec |[How to: Find Elements in a Namespace (XPath-LINQ to XML) (C#)](../../../../csharp/programming-guide/concepts/linq/how-to-find-elements-in-a-namespace-xpath-linq-to-xml.md)|Compares the use of the XPath class with the [!INCLUDE[sqltecxlinq](~/includes/sqltecxlinq-md.md)] property of the class for working with XML namespaces.

The associated XPath expression is:`"./aw:*"`| |[How to: Find Preceding Siblings (XPath-LINQ to XML) (C#)](../../../../csharp/programming-guide/concepts/linq/how-to-find-preceding-siblings-xpath-linq-to-xml.md)|Compares the XPath `preceding-sibling` axis to the [!INCLUDE[sqltecxlinq](~/includes/sqltecxlinq-md.md)] child axis.

The associated XPath expression is:`"preceding-sibling::*"`| |[How to: Find Descendants of a Child Element (XPath-LINQ to XML) (C#)](../../../../csharp/programming-guide/concepts/linq/how-to-find-descendants-of-a-child-element-xpath-linq-to-xml.md)|Compares how to get the descendant elements of a child element with a particular name with XPath and [!INCLUDE[sqltecxlinq](~/includes/sqltecxlinq-md.md)].

The associated XPath expression is:`"./Paragraph//Text/text()"`| -|[How to: Find a Union of Two Location Paths (XPath-LINQ to XML) (C#)](../../../../csharp/programming-guide/concepts/linq/how-to-find-a-union-of-two-location-paths-xpath-linq-to-xml.md)|Compares the use of the union operator, `|`, in XPath with the standard query operator in [!INCLUDE[sqltecxlinq](~/includes/sqltecxlinq-md.md)].

The associated XPath expression is:`"//Category|//Price"`| +|[How to: Find a Union of Two Location Paths (XPath-LINQ to XML) (C#)](../../../../csharp/programming-guide/concepts/linq/how-to-find-a-union-of-two-location-paths-xpath-linq-to-xml.md)|Compares the use of the union operator, |, in XPath with the standard query operator in [!INCLUDE[sqltecxlinq](~/includes/sqltecxlinq-md.md)].

The associated XPath expression is:"//Category|//Price"| |[How to: Find Sibling Nodes (XPath-LINQ to XML) (C#)](../../../../csharp/programming-guide/concepts/linq/how-to-find-sibling-nodes-xpath-linq-to-xml.md)|Compares how to find all siblings of a node that have a specific name with XPath and [!INCLUDE[sqltecxlinq](~/includes/sqltecxlinq-md.md)].

The associated XPath expression is:`"../Book"`| |[How to: Find an Attribute of the Parent (XPath-LINQ to XML) (C#)](../../../../csharp/programming-guide/concepts/linq/how-to-find-an-attribute-of-the-parent-xpath-linq-to-xml.md)|Compares how to navigate to the parent element and find an associated attribute using XPath and [!INCLUDE[sqltecxlinq](~/includes/sqltecxlinq-md.md)].

The associated XPath expression is:`"../@id"`| |[How to: Find Attributes of Siblings with a Specific Name (XPath-LINQ to XML) (C#)](../../../../csharp/programming-guide/concepts/linq/how-to-find-attributes-of-siblings-with-a-specific-name-xpath-linq-to-xml.md)|Compares how to find specific attributes of the siblings of the context node with XPath and [!INCLUDE[sqltecxlinq](~/includes/sqltecxlinq-md.md)].

The associated XPath expression is:`"``../Book/@id``"`| diff --git a/docs/framework/tools/ngen-exe-native-image-generator.md b/docs/framework/tools/ngen-exe-native-image-generator.md index d771ceaf2576d..ac4c3d271aa03 100644 --- a/docs/framework/tools/ngen-exe-native-image-generator.md +++ b/docs/framework/tools/ngen-exe-native-image-generator.md @@ -83,7 +83,7 @@ ngen /? | /help |`uninstall` [`assemblyName` | `assemblyPath`] [`scenarios`] [`config`]|Delete the native images of an assembly and its dependencies from the native image cache.

To uninstall a single image and its dependencies, use the same command-line arguments that were used to install the image. **Note:** Starting with the [!INCLUDE[net_v40_long](../../../includes/net-v40-long-md.md)], the action `uninstall` * is no longer supported.| |`update` [`/queue`]|Update native images that have become invalid.

If `/queue` is specified, the updates are queued for the native image service. Updates are always scheduled at priority 3, so they run when the computer is idle.| |`display` [`assemblyName` | `assemblyPath`]|Display the state of the native images for an assembly and its dependencies.

If no argument is supplied, everything in the native image cache is displayed.| -|`executeQueuedItems` [`1``|``2``|``3`]

-or-

`eqi` [1|2|3]|Execute queued compilation jobs.

If a priority is specified, compilation jobs with greater or equal priority are executed. If no priority is specified, all queued compilation jobs are executed.| +|`executeQueuedItems` [1|2|3]

-or-

`eqi` [1|2|3]|Execute queued compilation jobs.

If a priority is specified, compilation jobs with greater or equal priority are executed. If no priority is specified, all queued compilation jobs are executed.| |`queue` {`pause` | `continue` | `status`}|Pause the native image service, allow the paused service to continue, or query the status of the service.| diff --git a/docs/framework/wcf/com-service-model-configuration-tool-comsvcconfig-exe.md b/docs/framework/wcf/com-service-model-configuration-tool-comsvcconfig-exe.md index df8269a2fb78d..eba93b4090590 100644 --- a/docs/framework/wcf/com-service-model-configuration-tool-comsvcconfig-exe.md +++ b/docs/framework/wcf/com-service-model-configuration-tool-comsvcconfig-exe.md @@ -53,11 +53,11 @@ ComSvcConfig.exe /install | /uninstall | /list [/application:`|Specifies the COM+ application to configure.

Short form `/a`.| -|`/contract:<` *ClassID* `|` *ProgID* `| *,` *InterfaceID* `|` *InterfaceName* `| *` `>`|Specifies the COM+ component and interface that will be configured as the contract for the service.

Short form `/c`.

While the wildcard character (*) can be used when you specify the component and interface names, we recommend that you do not use it, because you might expose interfaces that you did not intend to.| -|`/hosting:<` *complus* `|` *was* `>`|Specifies whether to use the COM+ hosting mode or the Web hosting mode.

Short form `/h`.

Using the COM+ hosting mode requires explicit activation of the COM+ application. Using the Web hosting mode allows the COM+ application to be automatically activated as required. If the COM+ application is a library application, it runs in the Internet Information Services (IIS) process. If the COM+ application is a server application, it runs in the Dllhost.exe process.| -|`/webSite:<` *WebsiteName* `>`|Specifies the Web site for hosting when Web hosting mode is used (see the `/hosting` flag).

Short form `/w`.

If no Web site is specified, the default Web site is used.| -|`/webDirectory:<` *WebDirectoryName* `>`|Specifies the virtual directory for hosting when Web hosting is used (see the `/hosting` flag).

Short form `/d`.| +|`/application:` \<*ApplicationID* | *ApplicationName*\>|Specifies the COM+ application to configure.

Short form `/a`.| +|`/contract:` \<*ClassID* | *ProgID* | \*,*InterfaceID* | *InterfaceName* | \*\>|Specifies the COM+ component and interface that will be configured as the contract for the service.

Short form `/c`.

While the wildcard character (\*) can be used when you specify the component and interface names, we recommend that you do not use it, because you might expose interfaces that you did not intend to.| +|`/hosting:` \<*complus* | *was*\>|Specifies whether to use the COM+ hosting mode or the Web hosting mode.

Short form `/h`.

Using the COM+ hosting mode requires explicit activation of the COM+ application. Using the Web hosting mode allows the COM+ application to be automatically activated as required. If the COM+ application is a library application, it runs in the Internet Information Services (IIS) process. If the COM+ application is a server application, it runs in the Dllhost.exe process.| +|`/webSite:` \<*WebsiteName*\>|Specifies the Web site for hosting when Web hosting mode is used (see the `/hosting` flag).

Short form `/w`.

If no Web site is specified, the default Web site is used.| +|`/webDirectory:` \<*WebDirectoryName*\>|Specifies the virtual directory for hosting when Web hosting is used (see the `/hosting` flag).

Short form `/d`.| |`/mex`|Adds a Metadata Exchange (MEX) service endpoint to the default service configuration to support clients that want to retrieve a contract definition from the service.

Short form `/x`.| |`/id`|Displays the application, component, and interface information as IDs.

Short form `/k`.| |`/nologo`|Prevents ComSvcConfig.exe from displaying its logo.

Short form `/n`.| diff --git a/docs/visual-basic/programming-guide/concepts/linq/linq-to-xml-for-xpath-users.md b/docs/visual-basic/programming-guide/concepts/linq/linq-to-xml-for-xpath-users.md index 2f9beb2a2df9d..072041fae4328 100644 --- a/docs/visual-basic/programming-guide/concepts/linq/linq-to-xml-for-xpath-users.md +++ b/docs/visual-basic/programming-guide/concepts/linq/linq-to-xml-for-xpath-users.md @@ -1,13 +1,9 @@ --- title: "LINQ to XML for XPath Users (Visual Basic)" -ms.custom: "" ms.date: "2015-07-20" ms.prod: .net -ms.reviewer: "" -ms.suite: "" ms.technology: - "devlang-visual-basic" -ms.tgt_pltfrm: "" ms.topic: "article" dev_langs: - "VB" @@ -15,9 +11,9 @@ ms.assetid: 0e64911c-a7cc-4c20-b927-ca99078b5656 caps.latest.revision: 3 author: dotnet-bot ms.author: dotnetcontent - --- # LINQ to XML for XPath Users (Visual Basic) + This set of topics show a number of XPath expressions and their [!INCLUDE[sqltecxlinq](~/includes/sqltecxlinq-md.md)] equivalents. All of the examples use the XPath functionality in [!INCLUDE[sqltecxlinq](~/includes/sqltecxlinq-md.md)] that is made available by the extension methods in . The examples execute both the XPath expression and the [!INCLUDE[sqltecxlinq](~/includes/sqltecxlinq-md.md)] expression. Each example then compares the results of both queries, validating that the XPath expression is functionally equivalent to the [!INCLUDE[sqltecxlinq](~/includes/sqltecxlinq-md.md)] query. As both types of queries return nodes from the same XML tree, the query result comparison is made using referential identity. @@ -36,7 +32,7 @@ This set of topics show a number of XPath expressions and their [!INCLUDE[sqltec |[How to: Find Elements in a Namespace (XPath-LINQ to XML) (Visual Basic)](../../../../visual-basic/programming-guide/concepts/linq/how-to-find-elements-in-a-namespace.md)|Compares the use of the XPath class with the [!INCLUDE[sqltecxlinq](~/includes/sqltecxlinq-md.md)] property of the class for working with XML namespaces.

The associated XPath expression is:`"./aw:*"`| |[How to: Find Preceding Siblings (XPath-LINQ to XML) (Visual Basic)](../../../../visual-basic/programming-guide/concepts/linq/how-to-find-preceding-siblings-xpath-linq-to-xml.md)|Compares the XPath `preceding-sibling` axis to the [!INCLUDE[sqltecxlinq](~/includes/sqltecxlinq-md.md)] child axis.

The associated XPath expression is:`"preceding-sibling::*"`| |[How to: Find Descendants of a Child Element (XPath-LINQ to XML) (Visual Basic)](../../../../visual-basic/programming-guide/concepts/linq/how-to-find-descendants-of-a-child-element-xpath-linq-to-xml.md)|Compares how to get the descendant elements of a child element with a particular name with XPath and [!INCLUDE[sqltecxlinq](~/includes/sqltecxlinq-md.md)].

The associated XPath expression is:`"./Paragraph//Text/text()"`| -|[How to: Find a Union of Two Location Paths (XPath-LINQ to XML) (Visual Basic)](../../../../visual-basic/programming-guide/concepts/linq/how-to-find-a-union-of-two-location-paths-xpath.md)|Compares the use of the union operator, `|`, in XPath with the standard query operator in [!INCLUDE[sqltecxlinq](~/includes/sqltecxlinq-md.md)].

The associated XPath expression is:`"//Category|//Price"`| +|[How to: Find a Union of Two Location Paths (XPath-LINQ to XML) (Visual Basic)](../../../../visual-basic/programming-guide/concepts/linq/how-to-find-a-union-of-two-location-paths-xpath.md)|Compares the use of the union operator, |, in XPath with the standard query operator in [!INCLUDE[sqltecxlinq](~/includes/sqltecxlinq-md.md)].

The associated XPath expression is:"//Category|//Price"| |[How to: Find Sibling Nodes (XPath-LINQ to XML) (Visual Basic)](../../../../visual-basic/programming-guide/concepts/linq/how-to-find-sibling-nodes-xpath-linq-to-xml.md)|Compares how to find all siblings of a node that have a specific name with XPath and [!INCLUDE[sqltecxlinq](~/includes/sqltecxlinq-md.md)].

The associated XPath expression is:`"../Book"`| |[How to: Find an Attribute of the Parent (XPath-LINQ to XML) (Visual Basic)](../../../../visual-basic/programming-guide/concepts/linq/how-to-find-an-attribute-of-the-parent-xpath-linq-to-xml.md)|Compares how to navigate to the parent element and find an associated attribute using XPath and [!INCLUDE[sqltecxlinq](~/includes/sqltecxlinq-md.md)].

The associated XPath expression is:`"../@id"`| |[How to: Find Attributes of Siblings with a Specific Name (XPath-LINQ to XML) (Visual Basic)](../../../../visual-basic/programming-guide/concepts/linq/how-to-find-attributes-of-siblings-with-a-specific-name.md)|Compares how to find specific attributes of the siblings of the context node with XPath and [!INCLUDE[sqltecxlinq](~/includes/sqltecxlinq-md.md)].

The associated XPath expression is:`"``../Book/@id``"`| From 2d0dfff3367de5caed2880570e3efa776f30467e Mon Sep 17 00:00:00 2001 From: Maira Wenzel Date: Tue, 19 Sep 2017 12:43:22 -0700 Subject: [PATCH 08/13] added info about relative paths for output (#3042) * added info about relative paths for output * edits --- docs/core/tools/dotnet-publish.md | 9 ++++----- 1 file changed, 4 insertions(+), 5 deletions(-) diff --git a/docs/core/tools/dotnet-publish.md b/docs/core/tools/dotnet-publish.md index 689bbcc07e240..e29132bff9c9e 100644 --- a/docs/core/tools/dotnet-publish.md +++ b/docs/core/tools/dotnet-publish.md @@ -1,15 +1,12 @@ --- title: dotnet publish command - .NET Core CLI description: The dotnet publish command publishes your .NET Core project into a directory. -keywords: dotnet-publish, CLI, CLI command, .NET Core -author: blackdwarf +author: mairaw ms.author: mairaw -ms.date: 08/12/2017 +ms.date: 09/01/2017 ms.topic: article ms.prod: .net-core ms.technology: dotnet-cli -ms.devlang: dotnet -ms.assetid: f2ef275a-7c5e-430a-8c30-65f52af62771 --- # dotnet publish @@ -89,6 +86,7 @@ Doesn't perform an implicit restore when running the command. `-o|--output ` Specifies the path for the output directory. If not specified, it defaults to *./bin/[configuration]/[framework]/* for a framework-dependent deployment or *./bin/[configuration]/[framework]/[runtime]* for a self-contained deployment. +If a relative path is provided, the output directory generated is relative to the project file location, not to the current working directory. `--self-contained` @@ -127,6 +125,7 @@ Specifies one or several [target manifests](../deploying/runtime-store.md) to us `-o|--output ` Specifies the path for the output directory. If not specified, it defaults to *./bin/[configuration]/[framework]/* for a framework-dependent deployment or *./bin/[configuration]/[framework]/[runtime]* for a self-contained deployment. +If a relative path is provided, the output directory generated is relative to the project file location, not to the current working directory. `-r|--runtime ` From 51d3e2d3a1680ce0147b6062411dbabfe3dc34ee Mon Sep 17 00:00:00 2001 From: Wasiim Hosenbocus Date: Wed, 20 Sep 2017 04:02:46 +0400 Subject: [PATCH 09/13] Update how-to-write-a-simple-parallel-for-loop.md (#3174) Updated Cut to Copy in Copy/Cut and Paste this code into ... --- .../how-to-write-a-simple-parallel-for-loop.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/standard/parallel-programming/how-to-write-a-simple-parallel-for-loop.md b/docs/standard/parallel-programming/how-to-write-a-simple-parallel-for-loop.md index 9108d7537c7c2..1cf15bcb08e0d 100644 --- a/docs/standard/parallel-programming/how-to-write-a-simple-parallel-for-loop.md +++ b/docs/standard/parallel-programming/how-to-write-a-simple-parallel-for-loop.md @@ -60,7 +60,7 @@ This topic contains two examples that illustrate the From af9512df683acb2f695aac0150ee20f44326c2fa Mon Sep 17 00:00:00 2001 From: Maira Wenzel Date: Tue, 19 Sep 2017 22:40:08 -0700 Subject: [PATCH 10/13] fixed formulas (#3182) * fixed formulas * fixed formula * fixed formula --- .../language-reference/keywords/using/using-static1.cs | 4 ++-- .../language-reference/keywords/using/using-static2.cs | 4 ++-- .../language-reference/keywords/using/using-static3.cs | 9 ++++----- 3 files changed, 8 insertions(+), 9 deletions(-) diff --git a/samples/snippets/csharp/language-reference/keywords/using/using-static1.cs b/samples/snippets/csharp/language-reference/keywords/using/using-static1.cs index 66596826801d6..3827387bc98cf 100644 --- a/samples/snippets/csharp/language-reference/keywords/using/using-static1.cs +++ b/samples/snippets/csharp/language-reference/keywords/using/using-static1.cs @@ -15,12 +15,12 @@ public double Diameter get { return 2 * Radius; } } - public double Area + public double Circumference { get { return 2 * Radius * Math.PI; } } - public double Circumference + public double Area { get { return Math.PI * Math.Pow(Radius, 2); } } diff --git a/samples/snippets/csharp/language-reference/keywords/using/using-static2.cs b/samples/snippets/csharp/language-reference/keywords/using/using-static2.cs index f65e40a06fcd5..5d5b1189152af 100644 --- a/samples/snippets/csharp/language-reference/keywords/using/using-static2.cs +++ b/samples/snippets/csharp/language-reference/keywords/using/using-static2.cs @@ -16,12 +16,12 @@ public double Diameter get { return 2 * Radius; } } - public double Area + public double Circumference { get { return 2 * Radius * PI; } } - public double Circumference + public double Area { get { return PI * Pow(Radius, 2); } } diff --git a/samples/snippets/csharp/language-reference/keywords/using/using-static3.cs b/samples/snippets/csharp/language-reference/keywords/using/using-static3.cs index e5b635140e12d..447e91d16bd31 100644 --- a/samples/snippets/csharp/language-reference/keywords/using/using-static3.cs +++ b/samples/snippets/csharp/language-reference/keywords/using/using-static3.cs @@ -39,12 +39,12 @@ public double Diameter get { return 2 * Radius; } } - public double Area + public double Circumference { get { return 2 * Radius * PI; } } - public double Circumference + public double Area { get { return PI * Pow(Radius, 2); } } @@ -55,6 +55,5 @@ public double Circumference // Information about the circle: // Radius: 12.45 // Diameter: 24.90 -// Circumference: 486.95 -// Area: 78.23 - +// Circumference: 78.23 +// Area: 486.95 From 058c717776f232ac571841bc08cd0c203bf4735c Mon Sep 17 00:00:00 2001 From: Maira Wenzel Date: Wed, 20 Sep 2017 00:48:03 -0700 Subject: [PATCH 11/13] simplifying version list (#3176) --- ...roubleshoot-blocked-installations-and-uninstallations.md | 6 +----- 1 file changed, 1 insertion(+), 5 deletions(-) diff --git a/docs/framework/install/troubleshoot-blocked-installations-and-uninstallations.md b/docs/framework/install/troubleshoot-blocked-installations-and-uninstallations.md index c64715ed8ff0f..be56a411895dd 100644 --- a/docs/framework/install/troubleshoot-blocked-installations-and-uninstallations.md +++ b/docs/framework/install/troubleshoot-blocked-installations-and-uninstallations.md @@ -1,13 +1,9 @@ --- title: "Troubleshoot blocked .NET Framework installations and uninstallations" -ms.custom: "" ms.date: "05/26/2017" ms.prod: ".net-framework" -ms.reviewer: "" -ms.suite: "" ms.technology: - "dotnet-clr" -ms.tgt_pltfrm: "" ms.topic: "article" helpviewer_keywords: - ".NET Framework, troubleshooting blocked installations" @@ -21,7 +17,7 @@ manager: "wpickett" # Troubleshoot blocked .NET Framework installations and uninstallations -When you run the [web or offline installer](../../../docs/framework/install/guide-for-developers.md) for the .NET Framework 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, or 4.7 you might encounter an issue that prevents or blocks the installation of the .NET Framework. The following table lists possible blocking issues and provides links to troubleshooting information. +When you run the [web or offline installer](../../../docs/framework/install/guide-for-developers.md) for the .NET Framework 4.5 or later versions, you might encounter an issue that prevents or blocks the installation of the .NET Framework. The following table lists possible blocking issues and provides links to troubleshooting information. In Windows 8 and above, the .NET Framework is an operating system component and cannot be independently uninstalled. Updates to the .NET Framework appear in the **Installed Updates** tab of the Control Panel **Programs and Features** app. For operating systems on which the .NET Framework is not preinstalled, the .NET Framework appears in the **Uninstall or change a program** tab (or the **Add/Remove programs** tab) of the **Program and Features** app in Control Panel. For information on the Windows versions on which the .NET Framework is preinstalled, see [System Requirements](../../../docs/framework/get-started/system-requirements.md). From 3536654b237537f2eb2e7b2c6d9f6c31b84f349c Mon Sep 17 00:00:00 2001 From: Hans De Mulder Date: Wed, 20 Sep 2017 09:50:23 +0200 Subject: [PATCH 12/13] Minor fixes : inconsistent wording and some ghost characters (#3171) * what's new Tuples : sample use InvariantCulture * vb tuple example fix new language feature sample * minor typos * compiler warning corrected to match previously mentioned number * removed a "ghost" quote * fixed inconsistent "read-only" and "read only" * code formatting (missing space) --- docs/csharp/whats-new/csharp-6.md | 10 +++++----- samples/snippets/csharp/new-in-6/Newcode.cs | 2 +- 2 files changed, 6 insertions(+), 6 deletions(-) diff --git a/docs/csharp/whats-new/csharp-6.md b/docs/csharp/whats-new/csharp-6.md index e81b1cf3754e7..70c94c4cc495b 100644 --- a/docs/csharp/whats-new/csharp-6.md +++ b/docs/csharp/whats-new/csharp-6.md @@ -64,7 +64,7 @@ auto-properties. C# 6 improves the auto-properties capabilities so that you can them in more scenarios. You won't need to fall back on the more verbose syntax of declaring and manipulating the backing field by hand so often. -The new syntax addresses scenarios for read only properties, and for initializing +The new syntax addresses scenarios for read-only properties, and for initializing the variable storage behind an auto-property. ### Read-only auto-properties @@ -97,7 +97,7 @@ public class Student public void ChangeName(string newLastName) { - // Generates CS 0200: Property or indexer cannot be assigned to -- it is read only + // Generates CS0200: Property or indexer cannot be assigned to -- it is read only LastName = newLastName; } } @@ -131,7 +131,7 @@ is part of the property declaration, making it easier to equate the storage allocation with public interface for `Student` objects. Property Initializers can be used with read/write properties as well -as read only properties, as shown here. +as read-only properties, as shown here. [!code-csharp[ReadWriteInitialization](../../../samples/snippets/csharp/new-in-6/newcode.cs#ReadWriteInitialization)] @@ -140,12 +140,12 @@ as read only properties, as shown here. The body of a lot of members that we write consist of only one statement that can be represented as an expression. You can reduce that syntax by writing an expression-bodied member instead. It works for methods and -read-only properties." For example, an override of `ToString()` is often +read-only properties. For example, an override of `ToString()` is often a great candidate: [!code-csharp[ToStringExpressionMember](../../../samples/snippets/csharp/new-in-6/newcode.cs#ToStringExpressionMember)] -You can also use expression-bodied members in read only properties as well: +You can also use expression-bodied members in read-only properties as well: [!code-csharp[FullNameExpressionMember](../../../samples/snippets/csharp/new-in-6/newcode.cs#FullNameExpressionMember)] diff --git a/samples/snippets/csharp/new-in-6/Newcode.cs b/samples/snippets/csharp/new-in-6/Newcode.cs index 7e792155a53af..6ae01daf2909c 100644 --- a/samples/snippets/csharp/new-in-6/Newcode.cs +++ b/samples/snippets/csharp/new-in-6/Newcode.cs @@ -35,7 +35,7 @@ public Student(string firstName, string lastName) public ICollection Grades { get; } = new List(); // // - public Standing YearInSchool { get; set;} = Standing.Freshman; + public Standing YearInSchool { get; set; } = Standing.Freshman; // // From 7b7b3edf860138a31467d68752d637653d5e40d8 Mon Sep 17 00:00:00 2001 From: Erik Dietrich Date: Wed, 20 Sep 2017 08:18:00 -0400 Subject: [PATCH 13/13] Adding C# version history post (#2867) * Create csharp-version-history.md * Added the actual text * Updated TOC with my entry. * first pass edit 1. Add Metadata 1. Change person 1. Formalize from blog post to docs style language. * Update csharp-version-history.md * fix build warnings on links. * respond to feedback * fixed build warnings * fixed version capitalization --- .../whats-new/csharp-version-history.md | 124 ++++++++++++++++++ docs/toc.md | 1 + 2 files changed, 125 insertions(+) create mode 100644 docs/csharp/whats-new/csharp-version-history.md diff --git a/docs/csharp/whats-new/csharp-version-history.md b/docs/csharp/whats-new/csharp-version-history.md new file mode 100644 index 0000000000000..0472c8c6fcc99 --- /dev/null +++ b/docs/csharp/whats-new/csharp-version-history.md @@ -0,0 +1,124 @@ +--- +title: The history of C# - C# Guide +description: What did the language look like in its earliest versions, and how has it evolved since? +keywords: C#, .NET, .NET Core, What's New, C# History +author: erikdietrich +ms.author: wiwagn +ms.date: 09/20/2017 +ms.topic: article +ms.prod: .net +ms.technology: devlang-csharp +ms.devlang: csharp +--- + +# The history of C# # + +What did the language look like in its earliest incarnations? And how has it evolved in the years since? + +## C# version 1.0 + +When you go back and look, C# version 1.0 looked a lot like Java. As [part of its stated design goals for ECMA](http://feeldotneteasy.blogspot.com/2011/01/c-design-goals.html), it sought to be a "simple, modern, general purpose object-oriented language." At the time, looking like Java meant it achieved those early design goals. + +But if you look back on C# 1.0 now, you'd find yourself a little dizzy. It lacked the built-in async capabilities and some of the slick functionality around generics that we take for granted. As a matter of fact, it lacked generics altogether. And [LINQ](../linq/index.md)? Not available yet. That would take some years to come out. + +C# version 1.0 looked stripped of features, compared to today. You'd find yourself writing some verbose code. But yet, you have to start somewhere. C# version 1.0 was a viable alternative to Java on the Windows platform. + +## C# version 2.0 + +Now things start to get interesting. Let's take a look at some major features of C# 2.0, released in 2005, along with Visual Studio 2005: + +- [Generics](../programming-guide/generics/index.md) +- [Partial types](../programming-guide/classes-and-structs/partial-classes-and-methods.md#partial-classes) +- [Anonymous methods](../programming-guide/statements-expressions-operators/anonymous-methods.md) +- [Nullable types](../programming-guide/nullable-types/index.md) +- [Iterators](../programming-guide/concepts/iterators.md) +- [Covariance and contravariance](../programming-guide/concepts/covariance-contravariance/index.md) + +While C# may have started as a pretty generic Object-Oriented (OO) language, C# version 2.0 changed that in a hurry. Once they had their feet under them, they went after some serious developer pain points. And they went after them in a big way. + +With generics, you have types and methods that can operate on an arbitrary type while still retaining type safety. So, for instance, having a lets you have `List` or `List` and perform type safe operations on those strings or integers while you iterate through them. This is better than creating `ListInt` inheritors or casting from `Object` for every operation. + +C# version 2.0 brought iterators. To put it succinctly, this lets you iterate through the items in a `List` (or other Enumerable types) with a `foreach` loop. Having this as a first-class part of the language dramatically enhanced readability of the language and people's ability to reason about the code. + +And yet, C# continued to play a bit of catch-up with Java. Java had already released versions that included generics and iterators. But that would soon change as the languages continued to evolve apart. + +## C# version 3.0 + +C# version 3.0 came in late 2007, along with Visual Studio 2008, though the full boat of language features would actually come with C# version 3.5. This version marked a major change in the growth of C#. It established C# as a truly formidable programming language. Let's take a look at some major features in this version: + +- [Auto implemented properties](../programming-guide/classes-and-structs/auto-implemented-properties.md) +- [Anonymous types](../programming-guide/classes-and-structs/anonymous-types.md) +- [Query expressions](../linq/query-expression-basics.md) +- [Lambda expression](https://www.daedtech.com/introduction-to-c-lambda-expressions/) +- [Expression trees](https://blogs.msdn.microsoft.com/charlie/2008/01/31/expression-tree-basics/) +- [Extension methods](https://www.codeproject.com/Tips/709310/Extension-Method-In-Csharp) + +In retrospect, many of these features seem both inevitable and inseparable. They all fit together strategically. It's generally thought that C# version's killer feature was the query expression, also known as Language-Integrated Query (LINQ). + +A more nuanced view examines expression tress, lambda expressions, and anonymous types as the foundation upon which LINQ is constructed. But, in either case, C# 3.0 presented a revolutionary concept. C# 3.0 had begun to lay the groundwork for turning C# into a hybrid Object Oriented / Functional language. + +Specifically, you could now write SQL-style, declarative queries to perform operations on collections, among other things. Instead of writing a `for` loop to compute the average of a list of integers, you could now do that as simply as `list.Average()`. The combination of query expressions and extension methods made it look as though that list of integers had gotten a whole lot smarter. + +It took time for people to really grasp and integrate the concept, but they gradually did. And now, years later, code is much more concise, simple, and functional. + +## C# version 4.0 + +C# version 4.0 would have had a difficult time living up to the groundbreaking status of version 3.0. With version 3.0, C# had moved the language firmly out from the shadow of Java and into prominence. The language was quickly becoming elegant. + +The next version did introduce some interesting new features: + +- [Dynamic binding](../language-reference/keywords/dynamic.md) +- [Named/optional arguments](../programming-guide/classes-and-structs/named-and-optional-arguments.md) +- [Generic covariant and contravariant](../../standard/generics/covariance-and-contravariance.md) +- [Embedded interop types](https://stackoverflow.com/questions/20514240/whats-the-difference-setting-embed-interop-types-true-and-false-in-visual-studi) + +Embedded interop types alleviated a deployment pain. Generic covariance and contravariance give you more power to use generics, but they're a bit academic and probably most appreciated by framework and library authors. Named and optional parameters let you eliminate many method overloads and provide convenience. But none of those features are exactly paradigm altering. + +The major feature was the introduction of the `dynamic` keyword. The `dynamic` keyword introduced into C# version 4.0 the ability to override the compiler on compile-time typing. By using the dynamic keyword, you can create constructs similar to dynamically typed languages like JavaScript. You can create a `dynamic x = "a string"` and then add six to it, leaving it up to the runtime to sort out what should happen next. + +This gives you the potential for errors but also great power within the language. + +## C# version 5.0 + +C# version 5.0 was a very focused version of the language. Nearly all of the effort for that version went into another groundbreaking language concept. Here is the major features list: + +- [Asynchronous members](../async.md) +- [Caller info attributes](https://www.codeproject.com/Tips/606379/Caller-Info-Attributes-in-Csharp) + +The caller info attribute lets you easily retrieve information about the context in which you're running without resorting to a ton of boilerplate reflection code. It has many uses in diagnostics and logging tasks. + +But `async` and `await` are the real stars of this release. When these features came out in 2012, C# changed the game again by baking asynchrony into the language as a first-class participant. If you've ever dealt with long running operations and the implementation of webs of callbacks, you probably loved this language feature. + +## C# version 6.0 + +With versions 3.0 and 5.0, C# had added some impressive features in an object oriented language. With version 6.0, it would go away from doing a dominant killer feature and instead release many features that delighted users of the language. Here are some of them: + +- [Static imports](../language-reference/keywords/using-static) +- [Exception filters](https://www.thomaslevesque.com/2015/06/21/exception-filters-in-c-6/) +- [Property initializers](http://geekswithblogs.net/WinAZ/archive/2015/06/30/whatrsquos-new-in-c-6.0-auto-property-initializers.aspx) +- [Expression bodied members](https://lostechies.com/jimmybogard/2015/12/17/c-6-feature-review-expression-bodied-function-members/) +- [Null propagator](https://davefancher.com/2014/08/14/c-6-0-null-propagation-operator/) +- [String interpolation](../language-reference/keywords/interpolated-strings.md) +- [nameof operator](https://stackoverflow.com/questions/31695900/what-is-the-purpose-of-nameof) +- [Dictionary initializer](../programming-guide/classes-and-structs/how-to-initialize-a-dictionary-with-a-collection-initializer.md) + +Each of these features is interesting in its own right. But if you look at them altogether, you see an interesting pattern. In this version, C# eliminated language boilerplate to make code more terse and readable. So for fans of clean, simple code, this language version was a huge win. + +They did one other thing along with this version, though it's not a traditional language feature in itself. They released [Roslyn the compiler as a service](https://github.com/dotnet/roslyn). The C# compiler is now written in C#, and you can use the compiler as part of your programming efforts. + +## C# version 7.0 + +The most recent major version is C# version 7.0. This version has some evolutionary and cool stuff in the vein of C# 6.0, but without the compiler as a service. Here are some of the new features: + +- [Out variables](http://www.c-sharpcorner.com/article/out-variables-in-c-sharp-7-0/) +- [Tuples and deconstruction](https://www.thomaslevesque.com/2016/08/23/tuple-deconstruction-in-c-7/) +- [Pattern matching](./csharp-7.md#pattern-matching) +- [Local functions](http://www.infoworld.com/article/3182416/application-development/c-7-in-depth-exploring-local-functions.html) +- [Expanded expression bodied members](./csharp-7.md#more-expression-bodied-members) +- [Ref locals and returns](./csharp-7.md#ref-locals-and-returns) + +All of these features offer cool new capabilities for developers and the opportunity to write even cleaner code than ever. A highlight is condensing the declaration of variables to use with the `out` keyword and by allowing multiple return values via tuple. + +But C# is being put to ever broader use. .NET Core now targets any operating system and has its eyes firmly on the cloud and on portability. This certainly occupies the language designers' thoughts and time, in addition to coming up with new features. + +_Article_ [_originally published on the NDepend blog_](https://blog.ndepend.com/c-versions-look-language-history/)_, courtesy of Erik Dietrich and Patrick Smacchia._ diff --git a/docs/toc.md b/docs/toc.md index 87ea6136823e3..5edb24dea92e0 100644 --- a/docs/toc.md +++ b/docs/toc.md @@ -197,6 +197,7 @@ ### [What's new in C# 7.1](csharp/whats-new/csharp-7-1.md) ### [What's new in C# 7](csharp/whats-new/csharp-7.md) ### [What's new in C# 6](csharp/whats-new/csharp-6.md) +### [C# Version History](csharp/whats-new/csharp-version-history.md) ### [Relationships between language and framework](csharp/whats-new/relationships-between-language-and-library.md)