C# 新 GUID（开发者用法）

什么是 GUID？

GUID（全局唯一标识符）是用于软件开发的唯一标识符。 在 .NET Framework中，GUID 以 System 命名空间内的 Guid 结构表示。 GUID 经常用作数据库中的主键，也用于需要跨系统唯一标识符的其他系统。

using System;

class Program
{
    static void Main()
    {
        // Generate a new GUID
        Guid newGuid = Guid.NewGuid();

        // Output the newly generated GUID to the console
        Console.WriteLine(newGuid);
    }
}

using System;

class Program
{
    static void Main()
    {
        // Generate a new GUID
        Guid newGuid = Guid.NewGuid();

        // Output the newly generated GUID to the console
        Console.WriteLine(newGuid);
    }
}

GUID 结构和格式

GUID 由 32 个十六进制数字组成，通常以 8-4-4-4-12 的格式显示（例如，e02fd0e4-00fd-090A-ca30-0d00a0038ba0）。 当使用ToString()方法转换为字符串时，GUID以这种格式表示。 这种表示方式使得在 JSON、XML 或数据库等基于文本的格式中存储 GUID 变得容易。

下面的代码示例展示了如何将 GUID 转换为字符串：

using System;

class Example
{
    static void Main()
    {
        // Generate a new GUID
        Guid newGuid = Guid.NewGuid();

        // Convert the GUID to a string
        string guidString = newGuid.ToString();

        // Output the GUID string
        Console.WriteLine(guidString);
    }
}

using System;

class Example
{
    static void Main()
    {
        // Generate a new GUID
        Guid newGuid = Guid.NewGuid();

        // Convert the GUID to a string
        string guidString = newGuid.ToString();

        // Output the GUID string
        Console.WriteLine(guidString);
    }
}

此代码将 GUID 转换为字符串并输出。

using System;

class ParseExample
{
    static void Main()
    {
        // Define a GUID string
        string guidString = "e02fd0e4-00fd-090A-ca30-0d00a0038ba0";

        // Convert the string back into a GUID object
        Guid parsedGuid = Guid.Parse(guidString);

        // Output the parsed GUID
        Console.WriteLine(parsedGuid);
    }
}

using System;

class ParseExample
{
    static void Main()
    {
        // Define a GUID string
        string guidString = "e02fd0e4-00fd-090A-ca30-0d00a0038ba0";

        // Convert the string back into a GUID object
        Guid parsedGuid = Guid.Parse(guidString);

        // Output the parsed GUID
        Console.WriteLine(parsedGuid);
    }
}

比较两个 GUID

可以比较 GUID 以查看它们是否相等。 Guid结构体实现了相等运算符(==)，因此您可以直接比较两个GUID对象。

以下是一个例子：

using System;

class CompareExample
{
    static void Main()
    {
        // Generate two new GUIDs
        Guid guid1 = Guid.NewGuid();
        Guid guid2 = Guid.NewGuid();

        // Compare the two GUIDs
        if (guid1 == guid2)
        {
            Console.WriteLine("The two GUIDs are the same.");
        }
        else
        {
            Console.WriteLine("The two GUIDs are different.");
        }
    }
}

using System;

class CompareExample
{
    static void Main()
    {
        // Generate two new GUIDs
        Guid guid1 = Guid.NewGuid();
        Guid guid2 = Guid.NewGuid();

        // Compare the two GUIDs
        if (guid1 == guid2)
        {
            Console.WriteLine("The two GUIDs are the same.");
        }
        else
        {
            Console.WriteLine("The two GUIDs are different.");
        }
    }
}

在此代码中，两个 GUID 被比较。 由于Guid.NewGuid()生成的每个GUID都是唯一的，因此结果通常是"两个GUID不同"。

使用 GUID 时的常见错误

1. 假设GUID是连续的： GUID是随机的，NewGuid()方法不会生成连续的值。 因此，您不应假设 GUID 会保持任何顺序。

2. 字符串比较而不是 GUID 比较： 将 GUID 作为字符串进行比较可能效率不高。 始终直接比较 GUID 对象，而不是将其转换为字符串并比较字符串值。

3. 在大型数据库中使用未索引的 GUID： 如果未正确索引，GUID 可能较大，可能会影响大型数据库的性能。 确保在将 GUID 作为主键使用时对其列进行索引。

.NET Core 和 Framework 中的 GUID

GUID 在 .NET Framework 和 .NET Core 中都受支持。 Guid 类的使用在 .NET 平台的不同版本之间保持一致。 因此，使用任何版本的.NET的开发人员都可以轻松使用Guid.NewGuid()方法生成GUID。

GUID 与 UUID

GUID 类似于 UUID（通用唯一标识符），这两个术语通常可以互换使用。 尽管在规范上有一些小的差异，但它们的功能都是生成唯一标识符。

在 IronPDF 中使用 GUID

IronPDF 是一个 PDF 库，用于从 HTML 生成 PDF 以及在 .NET 应用程序中进行其他 PDF 操作。 当您需要为 PDF 文档生成唯一的文件名时，可以将 IronPDF 与 GUID 结合使用。 这确保了每个生成的 PDF 都有一个唯一的名称，从而防止任何文件覆盖或命名冲突。 这是一个使用 GUID 的 IronPDF 的简单示例：

using System;
using IronPdf;

class Program
{
    static void Main()
    {
        // Generate a new GUID object for the PDF filename
        Guid pdfId = Guid.NewGuid();
        string filename = $"{pdfId}.pdf";

        // Create a PDF document using IronPDF
        var renderer = new ChromePdfRenderer();
        var pdfDocument = renderer.RenderHtmlAsPdf("<h1>Hello, World!</h1>");

        // Save the PDF with the unique filename
        pdfDocument.SaveAs(filename);
        Console.WriteLine($"PDF saved as: {filename}");
    }
}

using System;
using IronPdf;

class Program
{
    static void Main()
    {
        // Generate a new GUID object for the PDF filename
        Guid pdfId = Guid.NewGuid();
        string filename = $"{pdfId}.pdf";

        // Create a PDF document using IronPDF
        var renderer = new ChromePdfRenderer();
        var pdfDocument = renderer.RenderHtmlAsPdf("<h1>Hello, World!</h1>");

        // Save the PDF with the unique filename
        pdfDocument.SaveAs(filename);
        Console.WriteLine($"PDF saved as: {filename}");
    }
}

在 Visual Studio 中运行上述代码并观察输出。

我们使用Guid.NewGuid()为每个PDF文件创建一个唯一的随机GUID。这个GUID被转换为字符串并用作文件名。

结论

在本文中，我们已经介绍了 C# 中的 GUID 基础知识。 您已经了解了如何生成新的 GUID，比较它们，从字符串中解析它们，以及在诸如数据库的实际场景中使用它们。 Guid.NewGuid()方法使得生成GUID的新实例变得容易，确保每个标识符在系统之间是唯一的。 在 .NET 中工作的开发人员可以依靠 GUID 为其应用程序提供随机性和唯一性。

IronPDF 理解在投资之前进行测试的重要性，这就是为什么我们提供免费试用。 您可以免费评估软件的性能。如果您觉得有用，许可证价格从$799开始。