Novo GUID em C# (Como funciona para desenvolvedores)

O que é um GUID?

Um GUID (Identificador Global Único) é um identificador único usado no desenvolvimento de software. No .NET Framework, os GUIDs são representados como uma estrutura Guid dentro do namespace System. Os GUIDs são frequentemente usados ​​como chaves primárias em bancos de dados, bem como para outros fins em outros sistemas onde identificadores únicos são necessários entre sistemas.

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);
    }
}

Imports System

Friend Class Program
	Shared Sub Main()
		' Generate a new GUID
		Dim newGuid As Guid = Guid.NewGuid()

		' Output the newly generated GUID to the console
		Console.WriteLine(newGuid)
	End Sub
End Class

Estrutura e formato do GUID

Um GUID consiste em 32 dígitos hexadecimais, normalmente exibidos no formato 8-4-4-4-12 (por exemplo, e02fd0e4-00fd-090A-ca30-0d00a0038ba0). Quando convertido em uma string usando o método ToString(), o GUID é representado neste formato. Essa representação facilita o armazenamento de GUIDs em formatos baseados em texto, como JSON, XML ou bancos de dados.

O exemplo de código abaixo mostra como converter um GUID em uma string:

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);
    }
}

Imports System

Friend Class Example
	Shared Sub Main()
		' Generate a new GUID
		Dim newGuid As Guid = Guid.NewGuid()

		' Convert the GUID to a string
		Dim guidString As String = newGuid.ToString()

		' Output the GUID string
		Console.WriteLine(guidString)
	End Sub
End Class

Este código converte o GUID em uma string e a exibe como saída.

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);
    }
}

Imports System

Friend Class ParseExample
	Shared Sub Main()
		' Define a GUID string
		Dim guidString As String = "e02fd0e4-00fd-090A-ca30-0d00a0038ba0"

		' Convert the string back into a GUID object
		Dim parsedGuid As Guid = Guid.Parse(guidString)

		' Output the parsed GUID
		Console.WriteLine(parsedGuid)
	End Sub
End Class

Comparando dois GUIDs

Os GUIDs podem ser comparados para verificar se são iguais ou não. A estrutura Guid implementa o operador de igualdade (==), então você pode comparar dois objetos GUID diretamente.

Eis um exemplo:

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.");
        }
    }
}

Imports System

Friend Class CompareExample
	Shared Sub Main()
		' Generate two new GUIDs
		Dim guid1 As Guid = Guid.NewGuid()
		Dim guid2 As Guid = Guid.NewGuid()

		' Compare the two GUIDs
		If guid1 = guid2 Then
			Console.WriteLine("The two GUIDs are the same.")
		Else
			Console.WriteLine("The two GUIDs are different.")
		End If
	End Sub
End Class

Neste código, os dois GUIDs são comparados. Como cada GUID gerado por Guid.NewGuid() é único, o resultado normalmente será "Os dois GUIDs são diferentes".

Erros comuns ao usar GUIDs

1. Supondo que os GUIDs sejam sequenciais: os GUIDs são aleatórios e o método NewGuid() não gera valores sequenciais. Portanto, não se deve presumir que os GUIDs manterão qualquer tipo de ordem.

2. Comparação de strings em vez de comparações de GUIDs: Comparar GUIDs como strings pode ser ineficiente. Sempre compare objetos GUID diretamente, em vez de convertê-los em strings e comparar os valores das strings.

3. Utilizando GUIDs em grandes bancos de dados sem indexação: Os GUIDs podem ser grandes e afetar o desempenho em grandes bancos de dados se não forem indexados corretamente. Certifique-se de que suas colunas GUID estejam indexadas ao usá-las como chaves primárias.

GUIDs no .NET Core e Framework

Os GUIDs são suportados tanto no .NET Framework quanto no .NET Core. O uso da classe Guid permanece consistente em diferentes versões da plataforma .NET . Portanto, os desenvolvedores que trabalham com qualquer versão do .NET podem gerar GUIDs facilmente usando o método Guid.NewGuid().

GUID vs UUID

Os GUIDs são semelhantes aos UUIDs (Identificadores Únicos Universais), e os termos são frequentemente usados ​​como sinônimos. Embora existam algumas pequenas diferenças nas especificações, elas servem ao mesmo propósito de gerar identificadores únicos.

Usando o IronPDF com GUID

IronPDF é uma biblioteca PDF para gerar PDFs a partir de HTML e realizar outras operações de PDF em aplicações .NET . Você pode combinar o IronPDF com GUIDs quando precisar gerar nomes de arquivo exclusivos para seus documentos PDF. Isso garante que cada PDF gerado tenha um nome único, evitando a sobrescrita de arquivos ou conflitos de nomenclatura. Aqui está um exemplo simples de como usar o IronPDF com um novo GUID:

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}");
    }
}

Imports System
Imports IronPdf

Friend Class Program
	Shared Sub Main()
		' Generate a new GUID object for the PDF filename
		Dim pdfId As Guid = Guid.NewGuid()
		Dim filename As String = $"{pdfId}.pdf"

		' Create a PDF document using IronPDF
		Dim renderer = New ChromePdfRenderer()
		Dim pdfDocument = renderer.RenderHtmlAsPdf("<h1>Hello, World!</h1>")

		' Save the PDF with the unique filename
		pdfDocument.SaveAs(filename)
		Console.WriteLine($"PDF saved as: {filename}")
	End Sub
End Class

Execute o código acima no Visual Studio e observe o resultado.

Usamos Guid.NewGuid() para criar um GUID aleatório exclusivo para cada arquivo PDF. Esse GUID é convertido em uma string e usado como nome do arquivo.

Conclusão

Neste artigo, abordamos os conceitos básicos de GUIDs em C#. Você já viu como gerar novos GUIDs, compará-los, analisá-los a partir de strings e usá-los em cenários práticos, como bancos de dados. O método Guid.NewGuid() facilita a geração de uma nova instância de um GUID, garantindo que cada identificador seja único em todos os sistemas. Os desenvolvedores que trabalham com .NET podem contar com GUIDs para fornecer aleatoriedade e exclusividade em seus aplicativos.

A IronPDF entende a importância de testar antes de investir, e é por isso que oferecemos um período de teste gratuito . Você pode avaliar o desempenho do software gratuitamente. Se achar vantajoso, as licenças começam em $799.