Campos vs. Propriedades em C# (Como funciona para desenvolvedores)

O que é um campo?

Um campo é uma variável que é declarada diretamente em uma classe ou estrutura. Os campos são normalmente usados ​​para armazenar dados diretamente, o que os torna simples, mas arriscados em termos de encapsulamento e controle.

public class DocumentSettings
{
    public string headerText; // Campo
}

public class DocumentSettings
{
    public string headerText; // Campo
}

Public Class DocumentSettings
    Public headerText As String ' Campo
End Class

Os campos são rápidos e leves, mas carecem de proteções como modificadores de acesso, métodos setter ou lógica de validação. Por isso, devem ser usadas com cautela, especialmente quando o valor é acessado diretamente por código externo.

O que é uma propriedade?

Em C#, uma propriedade atua como uma interface controlada para um campo. Ele oferece uma maneira flexível de recuperar ou atribuir um valor de propriedade, permitindo ao mesmo tempo lógica adicional dentro de seus acessadores get ou set.

public class DocumentSettings
{
    public string HeaderText { get; set; } // Propriedade
}

public class DocumentSettings
{
    public string HeaderText { get; set; } // Propriedade
}

Public Class DocumentSettings
    Public Property HeaderText As String ' Propriedade
End Class

As propriedades são ideais para acesso a dados públicos porque oferecem encapsulamento e podem ser facilmente integradas a frameworks que utilizam reflexão, como o IronPDF.

Principais diferenças entre campos e propriedades

Recurso

Campo

Propriedade

Encapsulamento

Não

Sim

Lógica de suporte

Não é possível.

Suportado via get/set

Adequado para reflexão

Não confiável

Sim

Vinculação de dados

Não é o ideal

Preferido

Resumindo: use propriedades para dados públicos , especialmente quando estiver trabalhando com ferramentas como o IronPDF , que dependem de reflexão ou serialização.

Exemplo: Configuração de exportação para PDF

// Campo: Might be ignored
public class PdfExportOptions
{
    public string footerHtml; // fields store data directly, but not safely
}
// Propriedade: Recognized and controlled
public class PdfExportOptions
{
    public string FooterHtml { get; set; } // easy to modify, validate, or hide
}

// Campo: Might be ignored
public class PdfExportOptions
{
    public string footerHtml; // fields store data directly, but not safely
}
// Propriedade: Recognized and controlled
public class PdfExportOptions
{
    public string FooterHtml { get; set; } // easy to modify, validate, or hide
}

Public Class PdfExportOptions
    Public footerHtml As String ' fields store data directly, but not safely
End Class

Public Class PdfExportOptions
    Public Property FooterHtml As String ' easy to modify, validate, or hide
End Class

Serialização e vinculação de dados no IronPDF

Funcionalidades do IronPDF , como modelos HTML, preenchimento de formulários ou inserção de metadados, dependem de propriedades porque são acessíveis por meio de reflexão. Se você estiver passando dados para modelos ou exportando formulários:

• Os campos podem ser totalmente ignorados.
• As propriedades garantem que os dados sejam recuperados e renderizados corretamente no arquivo final.

Isso é especialmente crucial ao trabalhar com modelos complexos ou dados gerados pelo usuário.

Utilize propriedades para interação com a API pública.

Se o seu modelo for consumido pelo IronPDF (ou qualquer biblioteca externa), use propriedades públicas com modificadores de acesso apropriados para garantir um acesso seguro e de fácil manutenção.

public class InvoiceData
{
    public string CustomerName { get; set; }
    public DateTime InvoiceDate { get; set; }
}

public class InvoiceData
{
    public string CustomerName { get; set; }
    public DateTime InvoiceDate { get; set; }
}

Public Class InvoiceData
	Public Property CustomerName() As String
	Public Property InvoiceDate() As DateTime
End Class

Isso garante que o IronPDF (e outras bibliotecas .NET ) possam acessar os valores por meio de reflexão e serialização.

Mantenha os campos privados e internos.

Utilize campos para lógica interna, onde você não deseja que componentes ou bibliotecas externas acessem os dados.

public class InvoiceData
{
    private string internalNote; // Not meant for IronPDF
}

public class InvoiceData
{
    private string internalNote; // Not meant for IronPDF
}

Public Class InvoiceData
	Private internalNote As String ' Not meant for IronPDF
End Class

Essa é uma boa prática para manter sua lógica limpa, segura e previsível.

Campos: Menos Seguros, Menos Controlados

Os campos expõem os dados diretamente , sem qualquer lógica ou mecanismos de proteção. Ao declarar um campo público, você torna esse valor passível de modificação direta de qualquer lugar em sua aplicação — ou mesmo por bibliotecas externas.

// Campo – no protection
public class Person
{
    public string name;
}

// Campo – no protection
public class Person
{
    public string name;
}

Public Class Person
    Public name As String
End Class

Com esta configuração:

• Qualquer pessoa pode ler ou escrever o valor do autor sem restrições.
• Não é possível interceptar alterações para aplicar validação, registro ou higienização.
• Bibliotecas como o IronPDF podem consumir ou sobrescrever esses dados de maneiras inesperadas se forem usadas incorretamente.

Essa falta de controle se torna um risco potencial de segurança , especialmente ao lidar com a entrada do usuário, gerar documentos dinâmicos ou expor objetos internos além dos limites da rede (por exemplo, por meio de APIs, serialização ou modelos Razor ).

Características: Mais seguro, mais flexível

As propriedades permitem controlar o acesso aos seus dados usando os métodos de acesso get e set. Você pode impor regras, validar entradas e restringir o acesso de gravação, tornando-as muito mais seguras.

// Propriedade – safer use of our Person class
public class Person
{
    private string _name;
    public string Name
    {
        get => _name;
        set
        {
            if (string.IsNullOrWhiteSpace(value))
                throw new ArgumentException("Name is required");
            _name = value.Trim();
        }
    }
}

// Propriedade – safer use of our Person class
public class Person
{
    private string _name;
    public string Name
    {
        get => _name;
        set
        {
            if (string.IsNullOrWhiteSpace(value))
                throw new ArgumentException("Name is required");
            _name = value.Trim();
        }
    }
}

Imports System

Public Class Person
    Private _name As String
    Public Property Name As String
        Get
            Return _name
        End Get
        Set(value As String)
            If String.IsNullOrWhiteSpace(value) Then
                Throw New ArgumentException("Name is required")
            End If
            _name = value.Trim()
        End Set
    End Property
End Class

Esta abordagem:

• Impede o armazenamento de dados incorretos.
• Oferece recursos para registrar acessos ou aplicar regras de negócios.
• Protege o estado interno da sua aplicação.
• Garante que qualquer biblioteca de terceiros (como o IronPDF) possa consumir seus dados de forma segura e previsível.

Em cenários sensíveis — como a geração de PDFs oficiais com metadados do usuário, faturas ou registros de auditoria — o uso de propriedades oferece controle total sobre o que entra e sai de seus objetos .

Por que isso é importante com o IronPDF

O IronPDF não "viola" inerentemente a integridade dos seus dados, mas depende de reflexão em muitas áreas. Se você estiver passando modelos de dados para templates Razor , campos de metadados ou configurações de exportação:

• Você deseja garantir que apenas valores higienizados e validados sejam expostos. Você deseja ter controle sobre como os dados são gravados e lidos.

O uso de propriedades permite controlar esse fluxo, enquanto os campos públicos deixam sua aplicação mais exposta a comportamentos indesejados.

O que este código faz

• Cria uma classe PdfMetadata com uma propriedade sanitizada .
• Utiliza o ChromePdfRenderer para renderizar um modelo HTML básico.
• Insere os dados do autor, após a anonimização, tanto no conteúdo HTML quanto nos metadados do PDF .
• Salva o resultado final em SecureOutput.pdf.