Skip to content

Commit fd68108

Browse files
Smaug123Smaug123
committed
Add information about console output encoding
1 parent 74ed42b commit fd68108

File tree

1 file changed

+50
-7
lines changed

1 file changed

+50
-7
lines changed

‎xml/System/Console.xml

Lines changed: 50 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -4413,7 +4413,7 @@ This method can be used to reacquire the standard output stream after it has bee
44134413
## Remarks
44144414
The text representation of `value` is produced by calling <xref:System.Boolean.ToString%2A?displayProperty=nameWithType>, which outputs either <xref:System.Boolean.TrueString?displayProperty=nameWithType> or <xref:System.Boolean.FalseString?displayProperty=nameWithType>.
44154415
4416-
4416+
The output is encoded according to <xref:System.Console.OutputEncoding%2A>.
44174417
44184418
## Examples
44194419
The following example illustrates the use of the `Write` method.
@@ -4475,6 +4475,8 @@ This method can be used to reacquire the standard output stream after it has bee
44754475
<remarks>
44764476
<format type="text/markdown"><![CDATA[
44774477
4478+
The output is encoded according to <xref:System.Console.OutputEncoding%2A>.
4479+
44784480
## Examples
44794481
The following example illustrates the use of the `Write` method.
44804482
@@ -4593,7 +4595,9 @@ This method can be used to reacquire the standard output stream after it has bee
45934595
## Remarks
45944596
The text representation of `value` is produced by calling <xref:System.Decimal.ToString%2A?displayProperty=nameWithType>.
45954597
4598+
The output is encoded according to <xref:System.Console.OutputEncoding%2A>.
45964599
4600+
This method is intended for writing text, so be sure that the input array is well-formed. For example, surrogate pairs in the input may be interpreted as runes and re-encoded before output, and a terminating unpaired surrogate may be truncated.
45974601
45984602
## Examples
45994603
The following example illustrates the use of the `Write` method.
@@ -4658,7 +4662,7 @@ This method can be used to reacquire the standard output stream after it has bee
46584662
## Remarks
46594663
The text representation of `value` is produced by calling the <xref:System.Double.ToString%2A?displayProperty=nameWithType> method.
46604664
4661-
4665+
The output is encoded according to <xref:System.Console.OutputEncoding%2A>.
46624666
46634667
## Examples
46644668
The following example illustrates the use of the `Write` method.
@@ -4723,6 +4727,7 @@ This method can be used to reacquire the standard output stream after it has bee
47234727
## Remarks
47244728
The text representation of `value` is produced by calling the <xref:System.Int32.ToString%2A?displayProperty=nameWithType> method.
47254729
4730+
The output is encoded according to <xref:System.Console.OutputEncoding%2A>.
47264731
47274732
47284733
## Examples
@@ -4788,6 +4793,7 @@ This method can be used to reacquire the standard output stream after it has bee
47884793
## Remarks
47894794
The text representation of `value` is produced by calling the <xref:System.Int64.ToString%2A?displayProperty=nameWithType> method.
47904795
4796+
The output is encoded according to <xref:System.Console.OutputEncoding%2A>.
47914797
47924798
47934799
## Examples
@@ -4860,6 +4866,7 @@ This method can be used to reacquire the standard output stream after it has bee
48604866
## Remarks
48614867
If `value` is `null`, nothing is written and no exception is thrown. Otherwise, the `ToString` method of `value` is called to produce its string representation, and the resulting string is written to the standard output stream.
48624868
4869+
The output is encoded according to <xref:System.Console.OutputEncoding%2A>.
48634870
48644871
48654872
## Examples
@@ -4925,6 +4932,7 @@ This method can be used to reacquire the standard output stream after it has bee
49254932
## Remarks
49264933
The text representation of `value` is produced by calling the <xref:System.Single.ToString%2A?displayProperty=nameWithType> method.
49274934
4935+
The output is encoded according to <xref:System.Console.OutputEncoding%2A>.
49284936
49294937
49304938
## Examples
@@ -4995,8 +5003,9 @@ This method can be used to reacquire the standard output stream after it has bee
49955003
<format type="text/markdown"><![CDATA[
49965004
49975005
## Remarks
4998-
If value is `null`, nothing is written to the standard output stream.
5006+
The output is encoded according to <xref:System.Console.OutputEncoding%2A>.
49995007
5008+
If value is `null`, nothing is written to the standard output stream.
50005009
50015010
50025011
## Examples
@@ -5068,6 +5077,7 @@ This method can be used to reacquire the standard output stream after it has bee
50685077
## Remarks
50695078
The text representation of `value` is produced by calling the <xref:System.UInt32.ToString%2A?displayProperty=nameWithType> method.
50705079
5080+
The output is encoded according to <xref:System.Console.OutputEncoding%2A>.
50715081
50725082
50735083
## Examples
@@ -5139,6 +5149,7 @@ This method can be used to reacquire the standard output stream after it has bee
51395149
## Remarks
51405150
The text representation of `value` is produced by calling the <xref:System.UInt64.ToString%2A?displayProperty=nameWithType> method.
51415151
5152+
The output is encoded according to <xref:System.Console.OutputEncoding%2A>.
51425153
51435154
51445155
## Examples
@@ -5237,6 +5248,7 @@ This method can be used to reacquire the standard output stream after it has bee
52375248
52385249
- For more information about formatting, see [Formatting Types](/dotnet/standard/base-types/formatting-types).
52395250
5251+
The output is encoded according to <xref:System.Console.OutputEncoding%2A>.
52405252
52415253
52425254
## Examples
@@ -5351,8 +5363,9 @@ This method can be used to reacquire the standard output stream after it has bee
53515363
53525364
- For more information about formatting, see [Formatting Types](/dotnet/standard/base-types/formatting-types).
53535365
5354-
The `arg` parameter is a parameter array. Arguments can be passed to the method either as an array or as list of five or more items. The examples illustrate both forms of method call.
5366+
The `arg` parameter is a parameter array. Arguments can be passed to the method either as an array or as list of five or more items. The examples illustrate both forms of method call.
53555367
5368+
The output is encoded according to <xref:System.Console.OutputEncoding%2A>.
53565369
53575370
53585371
## Examples
@@ -5437,6 +5450,10 @@ This method can be used to reacquire the standard output stream after it has bee
54375450
## Remarks
54385451
This method writes `count` characters starting at position `index` of `buffer` to the standard output stream.
54395452
5453+
The output is encoded according to <xref:System.Console.OutputEncoding%2A>.
5454+
5455+
This method is intended for writing text, so be sure that the input array is well-formed. For example, surrogate pairs in the input may be interpreted as runes and re-encoded before output, and a terminating unpaired surrogate may be truncated.
5456+
54405457
]]></format>
54415458
</remarks>
54425459
<exception cref="T:System.ArgumentNullException">
@@ -5536,7 +5553,7 @@ This method can be used to reacquire the standard output stream after it has bee
55365553
55375554
- For more information about formatting, see [Formatting Types](/dotnet/standard/base-types/formatting-types).
55385555
5539-
5556+
The output is encoded according to <xref:System.Console.OutputEncoding%2A>.
55405557
55415558
## Examples
55425559
The following example uses the `WriteLine` method to demonstrate the standard formatting specifiers for numbers, dates, and enumerations.
@@ -5653,7 +5670,7 @@ This method can be used to reacquire the standard output stream after it has bee
56535670
56545671
- For more information about formatting, see [Formatting Types](/dotnet/standard/base-types/formatting-types).
56555672
5656-
5673+
The output is encoded according to <xref:System.Console.OutputEncoding%2A>.
56575674
56585675
## Examples
56595676
The following example uses the `WriteLine` method to demonstrate the standard formatting specifiers for numbers, dates, and enumerations.
@@ -5757,6 +5774,7 @@ This method can be used to reacquire the standard output stream after it has bee
57575774
57585775
- For more information about formatting, see [Formatting Types](/dotnet/standard/base-types/formatting-types).
57595776
5777+
The output is encoded according to <xref:System.Console.OutputEncoding%2A>.
57605778
57615779
57625780
## Examples
@@ -5793,6 +5811,8 @@ This method can be used to reacquire the standard output stream after it has bee
57935811
## Remarks
57945812
The default line terminator is a string whose value is a carriage return followed by a line feed ("\r\n" in C#, or `vbCrLf` in Visual Basic). You can change the line terminator by setting the <xref:System.IO.TextWriter.NewLine%2A?displayProperty=nameWithType> property of the <xref:System.Console.Out%2A> property to another string.
57955813
5814+
Strings are encoded according to <xref:System.Console.OutputEncoding%2A>.
5815+
57965816
]]></format>
57975817
</remarks>
57985818
</Docs>
@@ -5910,7 +5930,7 @@ This method can be used to reacquire the standard output stream after it has bee
59105930
59115931
For more information about the line terminator, see the Remarks section of the <xref:System.Console.WriteLine%2A> method that takes no parameters.
59125932
5913-
5933+
The output is encoded according to <xref:System.Console.OutputEncoding%2A>.
59145934
59155935
## Examples
59165936
The following example generates ten random integers and uses the <xref:System.Console.WriteLine%28System.Boolean%29?displayProperty=nameWithType> method to indicate whether they are even.
@@ -5975,6 +5995,7 @@ This method can be used to reacquire the standard output stream after it has bee
59755995
## Remarks
59765996
For more information about the line terminator, see the Remarks section of the <xref:System.Console.WriteLine%2A> method that takes no parameters.
59775997
5998+
The output is encoded according to <xref:System.Console.OutputEncoding%2A>.
59785999
59796000
59806001
## Examples
@@ -6046,6 +6067,10 @@ This method can be used to reacquire the standard output stream after it has bee
60466067
## Remarks
60476068
For more information about the line terminator, see the Remarks section of the <xref:System.Console.WriteLine%2A> method that takes no parameters.
60486069
6070+
The output is encoded according to <xref:System.Console.OutputEncoding%2A>.
6071+
6072+
This method is intended for writing text, so be sure that the input array is well-formed. For example, surrogate pairs in the input may be interpreted as runes and re-encoded before output, and a terminating unpaired surrogate may be truncated.
6073+
60496074
]]></format>
60506075
</remarks>
60516076
<exception cref="T:System.IO.IOException">An I/O error occurred.</exception>
@@ -6103,6 +6128,7 @@ This method can be used to reacquire the standard output stream after it has bee
61036128
61046129
For more information about the line terminator, see the Remarks section of the <xref:System.Console.WriteLine%2A> method that takes no parameters.
61056130
6131+
The output is encoded according to <xref:System.Console.OutputEncoding%2A>.
61066132
61076133
61086134
## Examples
@@ -6169,6 +6195,7 @@ This method can be used to reacquire the standard output stream after it has bee
61696195
61706196
For more information about the line terminator, see the Remarks section of the <xref:System.Console.WriteLine%2A> method that takes no parameters.
61716197
6198+
The output is encoded according to <xref:System.Console.OutputEncoding%2A>.
61726199
61736200
61746201
## Examples
@@ -6235,6 +6262,7 @@ This method can be used to reacquire the standard output stream after it has bee
62356262
62366263
For more information about the line terminator, see the Remarks section of the <xref:System.Console.WriteLine%2A> method that takes no parameters.
62376264
6265+
The output is encoded according to <xref:System.Console.OutputEncoding%2A>.
62386266
62396267
62406268
## Examples
@@ -6301,6 +6329,7 @@ This method can be used to reacquire the standard output stream after it has bee
63016329
63026330
For more information about the line terminator, see the Remarks section of the <xref:System.Console.WriteLine%2A> method that takes no parameters.
63036331
6332+
The output is encoded according to <xref:System.Console.OutputEncoding%2A>.
63046333
63056334
63066335
## Examples
@@ -6374,6 +6403,7 @@ This method can be used to reacquire the standard output stream after it has bee
63746403
63756404
For more information about the line terminator, see the Remarks section of the <xref:System.Console.WriteLine%2A> method that takes no parameters.
63766405
6406+
The output is encoded according to <xref:System.Console.OutputEncoding%2A>.
63776407
63786408
63796409
## Examples
@@ -6441,6 +6471,7 @@ This method can be used to reacquire the standard output stream after it has bee
64416471
64426472
For more information about the line terminator, see the Remarks section of the <xref:System.Console.WriteLine%2A> method that takes no parameters.
64436473
6474+
The output is encoded according to <xref:System.Console.OutputEncoding%2A>.
64446475
64456476
64466477
## Examples
@@ -6514,6 +6545,7 @@ This method can be used to reacquire the standard output stream after it has bee
65146545
65156546
For more information about the line terminator, see the Remarks section of the <xref:System.Console.WriteLine> method.
65166547
6548+
The output is encoded according to <xref:System.Console.OutputEncoding%2A>.
65176549
65186550
65196551
## Examples
@@ -6587,6 +6619,7 @@ This method can be used to reacquire the standard output stream after it has bee
65876619
65886620
For more information about the line terminator, see the Remarks section of the <xref:System.Console.WriteLine%2A> method that takes no parameters.
65896621
6622+
The output is encoded according to <xref:System.Console.OutputEncoding%2A>.
65906623
65916624
65926625
## Examples
@@ -6659,6 +6692,7 @@ This method can be used to reacquire the standard output stream after it has bee
66596692
66606693
For more information about the line terminator, see the Remarks section of the <xref:System.Console.WriteLine%2A> method that takes no parameters.
66616694
6695+
The output is encoded according to <xref:System.Console.OutputEncoding%2A>.
66626696
66636697
66646698
## Examples
@@ -6758,6 +6792,7 @@ This method can be used to reacquire the standard output stream after it has bee
67586792
67596793
For more information about the line terminator, see the Remarks section of the <xref:System.Console.WriteLine%2A> method that takes no parameters.
67606794
6795+
The output is encoded according to <xref:System.Console.OutputEncoding%2A>.
67616796
67626797
67636798
## Examples
@@ -6872,6 +6907,7 @@ This method can be used to reacquire the standard output stream after it has bee
68726907
68736908
For more information about the line terminator, see the Remarks section of the <xref:System.Console.WriteLine%2A> method that takes no parameters.
68746909
6910+
The output is encoded according to <xref:System.Console.OutputEncoding%2A>.
68756911
68766912
68776913
## Examples
@@ -6957,6 +6993,10 @@ This method can be used to reacquire the standard output stream after it has bee
69576993
69586994
For more information about the line terminator, see the Remarks section of the <xref:System.Console.WriteLine%2A> method that takes no parameters.
69596995
6996+
The output is encoded according to <xref:System.Console.OutputEncoding%2A>.
6997+
6998+
This method is intended for writing text, so be sure that the input array is well-formed. For example, surrogate pairs in the input may be interpreted as runes and re-encoded before output, and a terminating unpaired surrogate may be truncated.
6999+
69607000
]]></format>
69617001
</remarks>
69627002
<exception cref="T:System.ArgumentNullException">
@@ -7058,6 +7098,7 @@ This method can be used to reacquire the standard output stream after it has bee
70587098
70597099
For more information about the line terminator, see the Remarks section of the <xref:System.Console.WriteLine%2A> method that takes no parameters.
70607100
7101+
The output is encoded according to <xref:System.Console.OutputEncoding%2A>.
70617102
70627103
70637104
## Examples
@@ -7176,6 +7217,7 @@ This method can be used to reacquire the standard output stream after it has bee
71767217
71777218
For more information about the line terminator, see the Remarks section of the <xref:System.Console.WriteLine%2A> method that takes no parameters.
71787219
7220+
The output is encoded according to <xref:System.Console.OutputEncoding%2A>.
71797221
71807222
71817223
## Examples
@@ -7281,6 +7323,7 @@ This method can be used to reacquire the standard output stream after it has bee
72817323
72827324
For more information about the line terminator, see the Remarks section of the <xref:System.Console.WriteLine%2A> method that takes no parameters.
72837325
7326+
The output is encoded according to <xref:System.Console.OutputEncoding%2A>.
72847327
72857328
72867329
## Examples

0 commit comments

Comments
 (0)