Import System.Guid and System.Type.Guid documentation (#9715)

* Import System.Guid and System.Type.Guid documentation - Clarify that Type.Guid is COM-interop specific - Delete COM-interop specific sample from System.Guid. This sample is not directly relevant to Guid type and there are other similar samples on GuidAttribute. * Delete unused snippets
dotnet · Mar 15, 2024 · 717df1d · 717df1d
1 parent e106740
commit 717df1d
Show file tree

Hide file tree

Showing 8 changed files with 2 additions and 220 deletions.
diff --git a/snippets/cpp/VS_Snippets_CLR/Guid/CPP/Guids.cpp b/snippets/cpp/VS_Snippets_CLR/Guid/CPP/Guids.cpp
diff --git a/snippets/csharp/System/Guid/Overview/Guids.cs b/snippets/csharp/System/Guid/Overview/Guids.cs
diff --git a/snippets/csharp/System/Guid/Overview/Project.csproj b/snippets/csharp/System/Guid/Overview/Project.csproj
diff --git a/snippets/fsharp/System/Guid/Overview/Guids.fs b/snippets/fsharp/System/Guid/Overview/Guids.fs
diff --git a/snippets/fsharp/System/Guid/Overview/fs.fsproj b/snippets/fsharp/System/Guid/Overview/fs.fsproj
diff --git a/snippets/visualbasic/VS_Snippets_CLR/Guid/VB/Guids.vb b/snippets/visualbasic/VS_Snippets_CLR/Guid/VB/Guids.vb
diff --git a/xml/System/Guid.xml b/xml/System/Guid.xml
@@ -114,18 +114,6 @@
 ## Remarks
  A GUID is a 128-bit integer (16 bytes) that can be used across all computers and networks wherever a unique identifier is required. Such an identifier has a very low probability of being duplicated.
 
-
-
-## Examples
- The following example uses the <xref:System.Runtime.InteropServices.GuidAttribute?displayProperty=nameWithType> class to assign a GUID to an interface and to a user-defined class. It retrieves the value of the GUID by calling the <xref:System.Attribute.GetCustomAttribute%2A> method, and compares it with two other GUIDs to determine whether they are equal.
-
- :::code language="cpp" source="~/snippets/cpp/VS_Snippets_CLR/Guid/CPP/Guids.cpp" id="Snippet1":::
- :::code language="csharp" source="~/snippets/csharp/System/Guid/Overview/Guids.cs" interactive="try-dotnet" id="Snippet1":::
- :::code language="fsharp" source="~/snippets/fsharp/System/Guid/Overview/Guids.fs" id="Snippet1":::
- :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR/Guid/VB/Guids.vb" id="Snippet1":::
-
- Note that the <xref:System.Runtime.InteropServices.GuidAttribute> attribute is typically used in an application to expose a type to COM. If you compile this example, you can run the [Assembly Registration tool (Regasm.exe)](/dotnet/framework/tools/regasm-exe-assembly-registration-tool) on the generated assembly to create registry (.reg) and type library (.tlb) files. The .reg file can be used to register the coclass in the registry, and the .tlb file can provide metadata for COM interop.
-
  ]]></format>
     </remarks>
   </Docs>

diff --git a/xml/System/Type.xml b/xml/System/Type.xml
@@ -11038,9 +11038,9 @@ Calling this method overload is the same as calling the <xref:System.Type.GetTyp
           <format type="text/markdown"><![CDATA[
 
 ## Remarks
- A GUID is associated with a type using the <xref:System.Runtime.InteropServices.GuidAttribute> attribute.
-
+ This property returns a GUID that's associated with a type using the <xref:System.Runtime.InteropServices.GuidAttribute> attribute. If the attribute is omitted, a GUID is assigned automatically.
 
+ The GUID returned by this property is typically used to expose a type to COM. It is not meant to be used as a unique identifier of the type.
 
 ## Examples
  The following example creates the class `MyClass1` with a public method, creates a `Type` object corresponding to `MyClass1`, and gets the <xref:System.Guid> structure using the `GUID` property of the `Type` class.