You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: xml/System.Text.RegularExpressions/CaptureCollection.xml
+24-93Lines changed: 24 additions & 93 deletions
Original file line number
Diff line number
Diff line change
@@ -575,7 +575,7 @@ A collection that is read-only does not allow the addition or removal of element
575
575
</ReturnValue>
576
576
<Parameters />
577
577
<Docs>
578
-
<summary>Removes all items from the collection.</summary>
578
+
<summary>Calling this method always throws <seecref="T:System.NotSupportedException" />.</summary>
579
579
<exceptioncref="T:System.NotSupportedException">The collection is read-only.</exception>
580
580
<remarks>To be added.</remarks>
581
581
</Docs>
@@ -652,19 +652,10 @@ A collection that is read-only does not allow the addition or removal of element
652
652
</Parameters>
653
653
<Docs>
654
654
<paramname="item">The object to remove from the collection.</param>
655
-
<summary>Removes the first occurrence of a specific object from the collection.</summary>
655
+
<summary>Calling this method always throws <seecref="T:System.NotSupportedException" />.</summary>
656
656
<exceptioncref="T:System.NotSupportedException">The collection is read-only.</exception>
657
-
<returns>
658
-
<seelangword="true" /> if <paramrefname="item" /> was successfully removed from the collection; otherwise, <seelangword="false" />. This method also returns <seelangword="false" /> if <paramrefname="item" /> is not found in the original collection.</returns>
659
-
<remarks>
660
-
<formattype="text/markdown"><![CDATA[
661
-
662
-
## Remarks
663
-
664
-
This method is not supported. This is a read-only collection.
665
-
666
-
]]></format>
667
-
</remarks>
657
+
<returns>Calling this method always throws <seecref="T:System.NotSupportedException" />.</returns>
@@ -973,21 +948,15 @@ This method is not supported. This is a read-only collection.
973
948
</ReturnValue>
974
949
<Docs>
975
950
<summary>Gets a value that indicates whether access to the collection is synchronized (thread-safe).</summary>
976
-
<value>false in all cases.</value>
951
+
<value><seelangword='false' /> in all cases.</value>
977
952
<remarks>
978
953
<formattype="text/markdown"><![CDATA[
979
954
980
955
## Remarks
981
956
982
957
This member is an explicit interface member implementation. It can be used only when the <xref:System.Text.RegularExpressions.CaptureCollection> instance is cast to an <xref:System.Collections.ICollection> interface.
983
958
984
-
985
-
986
-
<xref:System.Collections.ICollection.SyncRoot%2A> returns an object, which can be used to synchronize access to the <xref:System.Collections.ICollection>.
987
-
Most collection classes in the <xref:System.Collections?displayProperty=nameWithType> namespace also implement a Synchronized method, which provides a synchronized wrapper around the underlying collection.
988
-
Enumerating through a collection is intrinsically not a thread-safe procedure. Even when a collection is synchronized, other threads can still modify the collection, which causes the enumerator to throw an exception. To guarantee thread safety during enumeration, you can either lock the collection during the entire enumeration or catch the exceptions resulting from changes made by other threads.
989
-
990
-
]]></format>
959
+
]]></format>
991
960
</remarks>
992
961
</Docs>
993
962
</Member>
@@ -1028,12 +997,6 @@ This member is an explicit interface member implementation. It can be used only
1028
997
1029
998
This member is an explicit interface member implementation. It can be used only when the <xref:System.Text.RegularExpressions.CaptureCollection> instance is cast to an <xref:System.Collections.ICollection> interface.
1030
999
1031
-
1032
-
1033
-
For collections whose underlying store is not publicly available, the expected implementation is to return the current instance. Note that the pointer to the current instance might not be sufficient for collections that wrap other collections; those should return the underlying collection's `SyncRoot` property.
1034
-
Most collection classes in the <xref:System.Collections?displayProperty=nameWithType> namespace also implement a `Synchronized` method, which provides a synchronized wrapper around the underlying collection. However, derived classes can provide their own synchronized version of the collection using the <xref:System.Collections.ICollection.SyncRoot%2A> property. The synchronizing code must perform operations on the <xref:System.Collections.ICollection.SyncRoot%2A> property of the collection, not directly on the collection. This ensures proper operation of collections that are derived from other objects. Specifically, it maintains proper synchronization with other threads that might be simultaneously modifying the collection instance.
1035
-
Enumerating through a collection is intrinsically not a thread-safe procedure. Even when a collection is synchronized, other threads can still modify the collection, which causes the enumerator to throw an exception. To guarantee thread safety during enumeration, you can either lock the collection during the entire enumeration or catch the exceptions resulting from changes made by other threads.
1036
-
1037
1000
]]></format>
1038
1001
</remarks>
1039
1002
</Docs>
@@ -1071,8 +1034,8 @@ This member is an explicit interface member implementation. It can be used only
1071
1034
</Parameters>
1072
1035
<Docs>
1073
1036
<paramname="value">The object to add to the collection.</param>
1074
-
<summary>Adds an item to the collection.</summary>
1075
-
<returns>The position into which the new element was inserted, or -1 to indicate that the item was not inserted into the collection.</returns>
1037
+
<summary>Calling this method always throws <seecref="T:System.NotSupportedException" />.</summary>
1038
+
<returns>Calling this method always throws <seecref="T:System.NotSupportedException" />.</returns>
1076
1039
<exceptioncref="T:System.NotSupportedException">The collection is read-only.</exception>
1077
1040
<remarks>To be added.</remarks>
1078
1041
</Docs>
@@ -1107,18 +1070,10 @@ This member is an explicit interface member implementation. It can be used only
1107
1070
</ReturnValue>
1108
1071
<Parameters />
1109
1072
<Docs>
1110
-
<summary>Removes all items from the collection.</summary>
1073
+
<summary>Calling this method always throws <seecref="T:System.NotSupportedException" />.</summary>
1111
1074
<exceptioncref="T:System.NotSupportedException">The collection is read-only.</exception>
1112
-
<remarks>
1113
-
<formattype="text/markdown"><
0 commit comments