GuidAttribute Class (System.Runtime.InteropServices)

Switch View

Collapse All

Language Filter

This page is specific to

Microsoft Visual Studio 2008/.NET Framework 3.5

Other versions are also available for the following:

.NET Framework Class Library

GuidAttribute Class

Supplies an explicit System..::.Guid when an automatic GUID is undesirable.

Namespace: System.Runtime.InteropServices
Assembly: mscorlib (in mscorlib.dll)

Syntax

Visual Basic (Declaration)

<AttributeUsageAttribute(AttributeTargets.Assembly Or AttributeTargets.Class Or AttributeTargets.Struct Or AttributeTargets.Enum Or AttributeTargets.Interface Or AttributeTargets.Delegate, Inherited := False)> _
<ComVisibleAttribute(True)> _
Public NotInheritable Class GuidAttribute _
    Inherits Attribute

Visual Basic (Usage)

Dim instance As GuidAttribute

[AttributeUsageAttribute(AttributeTargets.Assembly|AttributeTargets.Class|AttributeTargets.Struct|AttributeTargets.Enum|AttributeTargets.Interface|AttributeTargets.Delegate, Inherited = false)]
[ComVisibleAttribute(true)]
public sealed class GuidAttribute : Attribute

Visual C++

[AttributeUsageAttribute(AttributeTargets::Assembly|AttributeTargets::Class|AttributeTargets::Struct|AttributeTargets::Enum|AttributeTargets::Interface|AttributeTargets::Delegate, Inherited = false)]
[ComVisibleAttribute(true)]
public ref class GuidAttribute sealed : public Attribute

JScript

public final class GuidAttribute extends Attribute

Remarks

You can apply this attribute to assemblies, interfaces, classes, enumerations, structures, or delegates, although the Type Library Importer (Tlbimp.exe) can apply it for you when it imports a type library.

The string passed to the attribute must be in a format that is an acceptable constructor argument for the type Guid. To avoid conflicts with the type Guid, use the long name GuidAttribute explicitly. Only use an explicit GUID when a type must have a specific GUID. If the attribute is omitted, a GUID is assigned automatically.

Examples

The following example demonstrates how to apply the GuidAttribute to a class that is exported to COM with a fixed GUID.

Visual Basic

Imports System
Imports System.Runtime.InteropServices


 <GuidAttribute("9ED54F84-A89D-4fcd-A854-44251E925F09")> _
 Public Class SampleClass
     ' Insert class members here.
 End Class

using System;
using System.Runtime.InteropServices;


[GuidAttribute("9ED54F84-A89D-4fcd-A854-44251E925F09")]
public class SampleClass 
{
    // Insert class members here.
}

Visual C++

using namespace System;
using namespace System::Runtime::InteropServices;


[GuidAttribute("9ED54F84-A89D-4fcd-A854-44251E925F09")]
public ref class SampleClass
{
    // Insert class members here.
};

JScript

import System
import System.Runtime.InteropServices


 public GuidAttribute("9ED54F84-A89D-4fcd-A854-44251E925F09")
 class SampleClass{
     // Insert class members here
 }

Inheritance Hierarchy

System..::.Object
System..::.Attribute
System.Runtime.InteropServices..::.GuidAttribute

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Platforms

Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98, Windows CE, Windows Mobile for Smartphone, Windows Mobile for Pocket PC, Xbox 360, Zune

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Version Information

.NET Framework

Supported in: 3.5, 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Supported in: 3.5, 2.0, 1.0

XNA Framework

Supported in: 3.0, 2.0, 1.0

Reference

GuidAttribute Members

System.Runtime.InteropServices Namespace

Guid

Other Resources

Type Library Importer (Tlbimp.exe)