.NET 도움말

C# Pair Class (How It Works For Developers)

Q: 튜플보다 페어 클래스를 사용하면 어떤 이점이 있나요?

튜플에 비해 Pair 클래스를 사용할 때의 장점은 Item1 및 Item2 대신 설명적인 속성 이름을 사용하여 코드 가독성이 향상된다는 점과 Pair는 변경 가능하므로 값을 수정할 수 있다는 점 등입니다.

업데이트됨:7월 28, 2025

A pair is a simple data structure that holds two related values. It provides a convenient way to bundle two distinct pieces of data together. Pairs are commonly used when a method needs to return two values or when working with key-value associations.

In C#, developers often resort to using tuples (Tuple<T1, T2>) for pairing values. However, tuples are immutable, and their elements are accessed via properties like Item1 and Item2, which can lead to less readable code when used extensively. This is where a custom Pair class comes in handy.

If you require a structure to hold two related objects and data hiding is not a priority, you can utilize the Pair class in your code. The Pair class does not encapsulate its object references. Instead, it exposes them directly to all calling codes as public class fields.

This design choice allows for straightforward access to the contained objects without the overhead of encapsulation. Also, at the end of the article, we will explore how IronPDF for PDF Generation from Iron Software Overview can be used to generate a PDF document.

Tuples

C# 7.0 introduced tuple syntax improvements, making tuples even easier to work with. Here's how you can declare and initialize tuples:

// Tuple declaration
var person = (name: "John", age: 30);

// Accessing tuple elements using named properties
Console.WriteLine($"Name: {person.name}, Age: {person.age}");

// Tuple deconstruction
var (name, age) = person;
Console.WriteLine($"Name: {name}, Age: {age}");

// Tuple declaration
var person = (name: "John", age: 30);

// Accessing tuple elements using named properties
Console.WriteLine($"Name: {person.name}, Age: {person.age}");

// Tuple deconstruction
var (name, age) = person;
Console.WriteLine($"Name: {name}, Age: {age}");

$vbLabelText $csharpLabel

Benefits of Tuples

Concise Syntax

Tuples allow you to express complex data structures using a concise syntax without the need for defining custom classes or structs.

Lightweight

Tuples are lightweight data structures, making them suitable for scenarios where you need temporary or intermediate storage of data.

Implicit Naming

With tuple syntax, you can implicitly name tuple elements, enhancing code readability and reducing the need for comments.

Returning Multiple Values from Methods

public (int Quotient, int Remainder) Divide(int dividend, int divisor)
{
    int quotient = dividend / divisor;
    int remainder = dividend % divisor;
    return (quotient, remainder);
}

var result = Divide(10, 3);
Console.WriteLine($"Quotient: {result.Quotient}, Remainder: {result.Remainder}");

public (int Quotient, int Remainder) Divide(int dividend, int divisor)
{
    int quotient = dividend / divisor;
    int remainder = dividend % divisor;
    return (quotient, remainder);
}

var result = Divide(10, 3);
Console.WriteLine($"Quotient: {result.Quotient}, Remainder: {result.Remainder}");

$vbLabelText $csharpLabel

Simplifying Method Signatures

public (string Name, string Surname) GetNameAndSurname()
{
    // Retrieve name and surname from a data source
    return ("John", "Doe");
}

var (name, surname) = GetNameAndSurname();
Console.WriteLine($"Name: {name}, Surname: {surname}");

public (string Name, string Surname) GetNameAndSurname()
{
    // Retrieve name and surname from a data source
    return ("John", "Doe");
}

var (name, surname) = GetNameAndSurname();
Console.WriteLine($"Name: {name}, Surname: {surname}");

$vbLabelText $csharpLabel

var point = (x: 10, y: 20);
var color = (r: 255, g: 0, b: 0);
var person = (name: "Alice", age: 25);

var point = (x: 10, y: 20);
var color = (r: 255, g: 0, b: 0);
var person = (name: "Alice", age: 25);

$vbLabelText $csharpLabel

Limitations and Considerations

While C# 7.0 tuples provide significant benefits, there are some limitations and considerations to keep in mind:

Tuples are limited in terms of expressiveness compared to custom classes or structs.
Tuple elements are accessed using Item1, Item2, etc. when explicit names are not provided, which can reduce code readability.

Pair Custom Class

public class Pair<T1, T2>
{
    public T1 First { get; set; }
    public T2 Second { get; set; }

    // Constructor to initialize the pair
    public Pair(T1 first, T2 second)
    {
        First = first;
        Second = second;
    }
}

public class Pair<T1, T2>
{
    public T1 First { get; set; }
    public T2 Second { get; set; }

    // Constructor to initialize the pair
    public Pair(T1 first, T2 second)
    {
        First = first;
        Second = second;
    }
}

$vbLabelText $csharpLabel

In this class, the types are defined at the time of usage, and the two properties are exposed as public properties.

Using the Pair Class

Now, let's explore some common use cases where the Pair class can be beneficial:

1. Storing Coordinates

// Creating a new instance of the Pair class to store coordinates
Pair<int, int> coordinates = new Pair<int, int>(10, 20);
Console.WriteLine($"X: {coordinates.First}, Y: {coordinates.Second}");

// Creating a new instance of the Pair class to store coordinates
Pair<int, int> coordinates = new Pair<int, int>(10, 20);
Console.WriteLine($"X: {coordinates.First}, Y: {coordinates.Second}");

$vbLabelText $csharpLabel

2. Returning Multiple Values from a Method

// Method returning a Pair, representing both quotient and remainder
public Pair<int, int> Divide(int dividend, int divisor)
{
    int quotient = dividend / divisor;
    int remainder = dividend % divisor;
    return new Pair<int, int>(quotient, remainder);
}

// Usage
Pair<int, int> result = Divide(10, 3);
Console.WriteLine($"Quotient: {result.First}, Remainder: {result.Second}");

// Method returning a Pair, representing both quotient and remainder
public Pair<int, int> Divide(int dividend, int divisor)
{
    int quotient = dividend / divisor;
    int remainder = dividend % divisor;
    return new Pair<int, int>(quotient, remainder);
}

// Usage
Pair<int, int> result = Divide(10, 3);
Console.WriteLine($"Quotient: {result.First}, Remainder: {result.Second}");

$vbLabelText $csharpLabel

3. Storing Key-Value Pairs

// Storing a key-value pair
Pair<string, int> keyValue = new Pair<string, int>("Age", 30);
Console.WriteLine($"Key: {keyValue.First}, Value: {keyValue.Second}");

// Storing a key-value pair
Pair<string, int> keyValue = new Pair<string, int>("Age", 30);
Console.WriteLine($"Key: {keyValue.First}, Value: {keyValue.Second}");

$vbLabelText $csharpLabel

Key-Value Pairs

Key-value pairs provide a simple and efficient way to associate data. In C#, the primary tool for working with key-value pairs is the Dictionary<TKey, TValue> class, a versatile and powerful collection type.

Understanding Key-Value Pairs

A key-value pair is a data structure that associates a unique key with a value. This association allows for efficient retrieval and manipulation of data based on its unique identifier. In C#, key-value pairs are commonly used for tasks such as caching, configuration management, and data storage.

`Dictionary<TKey, TValue>` in C#

The Dictionary<TKey, TValue> class in C# is a generic collection that stores key-value pairs. It provides fast lookups based on the keys and is widely used for managing associative data.

Creating and Populating a Dictionary

Dictionary<string, int> ages = new Dictionary<string, int>
{
    { "Alice", 30 },
    { "Bob", 35 },
    { "Charlie", 25 }
};

Dictionary<string, int> ages = new Dictionary<string, int>
{
    { "Alice", 30 },
    { "Bob", 35 },
    { "Charlie", 25 }
};

$vbLabelText $csharpLabel

Accessing Values by Key

// Directly access a value by its key
Console.WriteLine($"Alice's age: {ages["Alice"]}");

// Directly access a value by its key
Console.WriteLine($"Alice's age: {ages["Alice"]}");

$vbLabelText $csharpLabel

Iterating Over Key-Value Pairs

// Iterate over all key-value pairs in the dictionary
foreach (var pair in ages)
{
    Console.WriteLine($"Name: {pair.Key}, Age: {pair.Value}");
}

// Iterate over all key-value pairs in the dictionary
foreach (var pair in ages)
{
    Console.WriteLine($"Name: {pair.Key}, Age: {pair.Value}");
}

$vbLabelText $csharpLabel

Advanced Scenarios

Handling Missing Keys

if (ages.TryGetValue("David", out int age))
{
    Console.WriteLine($"David's age: {age}");
}
else
{
    Console.WriteLine("David's age is not available.");
}

if (ages.TryGetValue("David", out int age))
{
    Console.WriteLine($"David's age: {age}");
}
else
{
    Console.WriteLine("David's age is not available.");
}

$vbLabelText $csharpLabel

Removing Entries

// Remove an entry given its key
ages.Remove("Charlie");

// Remove an entry given its key
ages.Remove("Charlie");

$vbLabelText $csharpLabel

Dictionary Initialization

// Initialize a dictionary with color codes
var colors = new Dictionary<string, string>
{
    { "red", "#FF0000" },
    { "green", "#00FF00" },
    { "blue", "#0000FF" }
};

// Initialize a dictionary with color codes
var colors = new Dictionary<string, string>
{
    { "red", "#FF0000" },
    { "green", "#00FF00" },
    { "blue", "#0000FF" }
};

$vbLabelText $csharpLabel

Beyond Dictionary: Alternatives and Considerations

While Dictionary<TKey, TValue> is a powerful tool, alternative approaches, and considerations depend on the specific requirements of your application:

ConcurrentDictionary<TKey, TValue>: If your application requires thread-safe access to the dictionary from multiple threads, consider using ConcurrentDictionary<TKey, TValue>.
ImmutableDictionary<TKey, TValue>: For scenarios where immutability is desired, ImmutableDictionary<TKey, TValue> from the System.Collections.Immutable namespace provides immutable key-value collections.
Custom Key-Value Pair Classes: In situations where you need additional functionality or specific behavior, consider creating custom key-value pair classes tailored to your requirements.

IronPDF Library

IronPDF by Iron Software Products is an excellent library for generating PDF documents. Its ease of use and efficiency are second to none.

IronPDF excels in HTML to PDF conversion, ensuring precise preservation of original layouts and styles. It's perfect for creating PDFs from web-based content such as reports, invoices, and documentation. With support for HTML files, URLs, and raw HTML strings, IronPDF easily produces high-quality PDF documents.

using IronPdf;

class Program
{
    static void Main(string[] args)
    {
        var renderer = new ChromePdfRenderer();

        // 1. Convert HTML String to PDF
        var htmlContent = "<h1>Hello, IronPDF!</h1><p>This is a PDF from an HTML string.</p>";
        var pdfFromHtmlString = renderer.RenderHtmlAsPdf(htmlContent);
        pdfFromHtmlString.SaveAs("HTMLStringToPDF.pdf");

        // 2. Convert HTML File to PDF
        var htmlFilePath = "path_to_your_html_file.html"; // Specify the path to your HTML file
        var pdfFromHtmlFile = renderer.RenderHtmlFileAsPdf(htmlFilePath);
        pdfFromHtmlFile.SaveAs("HTMLFileToPDF.pdf");

        // 3. Convert URL to PDF
        var url = "http://ironpdf.com"; // Specify the URL
        var pdfFromUrl = renderer.RenderUrlAsPdf(url);
        pdfFromUrl.SaveAs("URLToPDF.pdf");
    }
}

using IronPdf;

class Program
{
    static void Main(string[] args)
    {
        var renderer = new ChromePdfRenderer();

        // 1. Convert HTML String to PDF
        var htmlContent = "<h1>Hello, IronPDF!</h1><p>This is a PDF from an HTML string.</p>";
        var pdfFromHtmlString = renderer.RenderHtmlAsPdf(htmlContent);
        pdfFromHtmlString.SaveAs("HTMLStringToPDF.pdf");

        // 2. Convert HTML File to PDF
        var htmlFilePath = "path_to_your_html_file.html"; // Specify the path to your HTML file
        var pdfFromHtmlFile = renderer.RenderHtmlFileAsPdf(htmlFilePath);
        pdfFromHtmlFile.SaveAs("HTMLFileToPDF.pdf");

        // 3. Convert URL to PDF
        var url = "http://ironpdf.com"; // Specify the URL
        var pdfFromUrl = renderer.RenderUrlAsPdf(url);
        pdfFromUrl.SaveAs("URLToPDF.pdf");
    }
}

$vbLabelText $csharpLabel

IronPDF can be installed from the NuGet package manager:

Install-Package IronPdf

Or from Visual Studio like this:

C# Pair Class (How It Works For Developers): Figure 1 - Installing IronPDF with the NuGet package manager

To generate a document with a tuple example, we can use the following code:

using IronPdf;

namespace IronPatterns
{
    class Program
    {
        static void Main()
        {
            Console.WriteLine("-----------Iron Software-------------");
            var renderer = new ChromePdfRenderer(); // var pattern
            var content = "<h1>Iron Software is Awesome</h1> Made with IronPDF!";
            content += "<h2>Demo C# Pair with Tuples</h2>";

            var result = Divide(10, 3);
            Console.WriteLine($"Quotient: {result.Item1}, Remainder: {result.Item2}");
            content += $"<p>When we divide 10 by 3:</p>";
            content += $"<p>Quotient: {result.Item1}, Remainder: {result.Item2}</p>";

            var pdf = renderer.RenderHtmlAsPdf(content);
            pdf.SaveAs("output.pdf"); // Saves PDF
        }

        // Method to demonstrate division using tuples
        public static (int Quotient, int Remainder) Divide(int dividend, int divisor)
        {
            int quotient = dividend / divisor;
            int remainder = dividend % divisor;
            return (quotient, remainder);
        }
    }
}

using IronPdf;

namespace IronPatterns
{
    class Program
    {
        static void Main()
        {
            Console.WriteLine("-----------Iron Software-------------");
            var renderer = new ChromePdfRenderer(); // var pattern
            var content = "<h1>Iron Software is Awesome</h1> Made with IronPDF!";
            content += "<h2>Demo C# Pair with Tuples</h2>";

            var result = Divide(10, 3);
            Console.WriteLine($"Quotient: {result.Item1}, Remainder: {result.Item2}");
            content += $"<p>When we divide 10 by 3:</p>";
            content += $"<p>Quotient: {result.Item1}, Remainder: {result.Item2}</p>";

            var pdf = renderer.RenderHtmlAsPdf(content);
            pdf.SaveAs("output.pdf"); // Saves PDF
        }

        // Method to demonstrate division using tuples
        public static (int Quotient, int Remainder) Divide(int dividend, int divisor)
        {
            int quotient = dividend / divisor;
            int remainder = dividend % divisor;
            return (quotient, remainder);
        }
    }
}

$vbLabelText $csharpLabel

Output

C# Pair Class (How It Works For Developers): Figure 2

Trial License for IronPDF

Get your IronPDF Trial License and place the license in the appsettings.json.

{
    "IronPdf.LicenseKey": "<Your Key>"
}

Conclusion

In this article, we've explored the concept of pairs and the importance of having a Pair class in C#. We've provided a simple implementation of the Pair custom class along with various use cases demonstrating its versatility and utility in everyday programming tasks.

Whether you're working with coordinates, returning multiple values from a method, or storing key-value associations, the Pair class can be a valuable addition to your programming skill set.

In addition to this, the IronPDF library functionality is a great combination skill set to have for developers to generate PDF documents on the fly as required in applications.

자주 묻는 질문

C#에서 Pair 클래스란 무엇인가요?

C#의 Pair 클래스는 두 개의 관련 값을 보유하도록 설계된 간단한 데이터 구조입니다. 공용 필드로서 속성에 직접 액세스할 수 있으므로 캡슐화가 우선 순위가 아닌 경우 튜플을 대체할 수 있는 편리한 방법입니다.

Pair 클래스는 C#의 튜플과 어떻게 다른가요?

Pair 클래스는 공용 필드를 통해 객체 참조를 직접 노출하여 가독성과 유연성을 향상시킨다는 점에서 튜플과 다릅니다. 반면에 튜플은 불변이며 Item1 및 Item2와 같은 속성을 통해 해당 요소에 액세스합니다.

튜플보다 페어 클래스를 사용하면 어떤 이점이 있나요?

튜플에 비해 Pair 클래스를 사용할 때의 장점은 Item1 및 Item2 대신 설명적인 속성 이름을 사용하여 코드 가독성이 향상된다는 점과 Pair는 변경 가능하므로 값을 수정할 수 있다는 점 등입니다.

Pair 클래스를 사용하여 키-값 쌍을 저장할 수 있나요?

예, Pair 클래스는 공개 필드를 통해 값에 직접 액세스할 수 있기 때문에 튜플에 비해 키-값 쌍을 더 읽기 쉬운 방식으로 저장하는 데 특히 유용합니다.

C#에서 Pair 클래스를 사용하는 일반적인 시나리오에는 어떤 것이 있나요?

Pair 클래스를 사용하는 일반적인 시나리오에는 좌표 저장, 메서드에서 여러 값 반환, 읽기 쉬운 형식으로 키-값 쌍 연결 관리 등이 포함됩니다.

개발자가 IronPDF 라이브러리를 사용하는 이유는 무엇인가요?

개발자는 HTML 콘텐츠에서 PDF를 생성하기 위해 IronPDF 라이브러리를 사용할 수 있습니다. 이 라이브러리는 원본 레이아웃과 스타일을 유지하여 보고서나 송장 같은 전문 문서를 간편하게 만들 수 있습니다.

C#으로 된 HTML 파일에서 PDF를 생성하려면 어떻게 해야 하나요?

IronPDF 라이브러리를 사용하여 C#의 HTML 파일에서 PDF를 생성할 수 있습니다. 이 라이브러리는 HTML 문자열과 파일을 고품질 PDF 문서로 변환하는 RenderHtmlAsPdf와 같은 메서드를 제공합니다.

PDF 생성에 라이브러리를 사용하면 어떤 이점이 있나요?

PDF 생성에 IronPDF와 같은 라이브러리를 사용하면 다양한 콘텐츠 소스에서 정확한 레이아웃과 스타일을 보존하면서 고품질 PDF 문서를 생성하는 프로세스를 간소화할 수 있습니다.

개발자 툴킷에서 Pair 클래스와 IronPDF 라이브러리는 어떤 역할을 하나요?

Pair 클래스와 IronPDF 라이브러리는 Pairs로 효율적인 데이터 구조 관리를, IronPDF로 안정적인 문서 생성 기능을 제공하여 복잡한 데이터 및 문서 워크플로우를 처리하는 데 유용하게 사용함으로써 개발자의 툴킷을 향상시킵니다.

커티스 차우

지금 바로 엔지니어링 팀과 채팅하세요

기술 문서 작성자

커티스 차우는 칼턴 대학교에서 컴퓨터 과학 학사 학위를 취득했으며, Node.js, TypeScript, JavaScript, React를 전문으로 하는 프론트엔드 개발자입니다. 직관적이고 미적으로 뛰어난 사용자 인터페이스를 만드는 데 열정을 가진 그는 최신 프레임워크를 활용하고, 잘 구성되고 시각적으로 매력적인 매뉴얼을 제작하는 것을 즐깁니다.

커티스는 개발 분야 외에도 사물 인터넷(IoT)에 깊은 관심을 가지고 있으며, 하드웨어와 소프트웨어를 통합하는 혁신적인 방법을 연구합니다. 여가 시간에는 게임을 즐기거나 디스코드 봇을 만들면서 기술에 대한 애정과 창의성을 결합합니다.

30일 무료 체험 시작하기

C# Pair Class (How It Works For Developers)

Tuples

Benefits of Tuples

Concise Syntax

Lightweight

Implicit Naming

Returning Multiple Values from Methods

Simplifying Method Signatures

Grouping Related Data

Limitations and Considerations

Pair Custom Class

Using the Pair Class

1. Storing Coordinates

2. Returning Multiple Values from a Method

3. Storing Key-Value Pairs

Key-Value Pairs

Understanding Key-Value Pairs

Dictionary<TKey, TValue> in C#

Creating and Populating a Dictionary

Accessing Values by Key

Iterating Over Key-Value Pairs

Advanced Scenarios

Handling Missing Keys

Removing Entries

Dictionary Initialization

Beyond Dictionary: Alternatives and Considerations

IronPDF Library

Output

Trial License for IronPDF

Conclusion

자주 묻는 질문

C#에서 Pair 클래스란 무엇인가요?

Pair 클래스는 C#의 튜플과 어떻게 다른가요?

튜플보다 페어 클래스를 사용하면 어떤 이점이 있나요?

Pair 클래스를 사용하여 키-값 쌍을 저장할 수 있나요?

C#에서 Pair 클래스를 사용하는 일반적인 시나리오에는 어떤 것이 있나요?

개발자가 IronPDF 라이브러리를 사용하는 이유는 무엇인가요?

C#으로 된 HTML 파일에서 PDF를 생성하려면 어떻게 해야 하나요?

PDF 생성에 라이브러리를 사용하면 어떤 이점이 있나요?

개발자 툴킷에서 Pair 클래스와 IronPDF 라이브러리는 어떤 역할을 하나요?

관련 기사

Bridging CLI Simplicity & .NET : Using Curl DotNet with IronPDF

RandomNumberGenerator C#

C# String Equals (How it Works for Developers)

다음 단계: 30일 무료 체험 시작하기

다음 단계: 30일 무료 체험 시작하기

전 세계 수백만 엔지니어들이 신뢰하는 제품입니다.

`Dictionary<TKey, TValue>` in C#