W obiektowo zorientowanym środowisku programowania C# wprowadzenie Podstawowych Konstruktorów wprowadza nowy poziom elegancji i prostoty do języka. Podstawowe konstruktory, obok funkcji takich jak interfejsy i wyrażenia kolekcji, pojawiły się w C# 12 jako potężna funkcja, oferując bardziej zwięzłą składnię do deklarowania konstruktorów z parametrami. Możesz zgłębić temat Podstawowych konstruktorów w przewodniku Microsoft C#.
W tym artykułe nauczymy się, jak efektywnie korzystać z Podstawowych Konstruktorów C# 12, badając ich funkcjonalność, przypadki użycia i jak zmieniają sposób podejścia programistów do inicjalizacji klas.
Konstruktorzy odgrywają kluczową rolę w programowaniu obiektowym, służąc jako wzór do inicjalizacji obiektów. Tradycyjnie, programiści C# używali domyślnych lub z parametrami konstruktorów do ustawienia początkowego stanu swoich klas. Jednak wprowadzenie Podstawowych Konstruktorów dodaje bardziej uproszczone podejście do tego istotnego aspektu rozwoju C#.
Podstawowy Konstruktor w C# to zwięzły sposób na deklarowanie i inicjalizację właściwości bezpośrednio w deklaracji klasy. Upraszcza proces definiowania i przypisywania wartości do właściwości, oferując bardziej deklaratywną i czytelną składnię.
Składnia dla Podstawowego Konstruktoru polega na deklarowaniu właściwości bezpośrednio w nagłówku klasy. Rozważmy podstawowy Person przykład klasy:
public class Person(string name, int age)
{
public string Name { get; } = name;
public int Age { get; } = age;
public override string ToString() => $"Name: {Name}, Age: {Age}";
}Public Class Person(String name, Integer age)
Public ReadOnly Property Name() As String = name
Public ReadOnly Property Age() As Integer = age
Public Overrides Function ToString() As String
Return $"Name: {Name}, Age: {Age}"
End Function
End ClassW powyższym fragmencie kodu klasa Person ma Podstawowy Konstruktor, który inicjalizuje właściwości członków instancji Name i Age. Parametry konstruktóra są deklarowane z nazwą klasy lub struktury, a w czasie definiowania publicznych właściwości, wartości parametrów są im przypisywane.
public readonly struct Point(double x, double y)
{
public double X { get; } = x;
public double Y { get; } = y;
public double Magnitude => Math.Sqrt(X * X + Y * Y);
}'INSTANT VB WARNING: VB has no equivalent to the C# readonly struct:
'ORIGINAL LINE: public readonly struct Point(double x, double y)
Public Structure Point(Double x, Double y)
Public ReadOnly Property X() As Double = x
Public ReadOnly Property Y() As Double = y
Public ReadOnly Property Magnitude() As Double
Get
Return Math.Sqrt(X * X + Y * Y)
End Get
End Property
End StructureW tym przykładzie, podstawowy konstruktor dla struktury Point inicjalizuje właściwości X i Y, pokazując jak zwięzła i ekspresyjna może być składnia.
public class Logger(string filePath = "log.txt", LogLevel level = LogLevel.Info)
{
private readonly string _filePath = filePath;
private readonly LogLevel _level = level;
public void Log(string message)
{
// Actual logging implementation using _filePath and _level
}
}'INSTANT VB TODO TASK: The following line contains an assignment within expression that was not extracted by Instant VB:
'ORIGINAL LINE: public class Logger(string filePath = "log.txt", LogLevel level = LogLevel.Info)
Public Class Logger(String filePath = "log.txt", LogLevel level = LogLevel.Info)
Private ReadOnly _filePath As String = filePath
Private ReadOnly _level As LogLevel = level
Public Sub Log(ByVal message As String)
' Actual logging implementation using _filePath and _level
End Sub
End ClassTutaj, podstawowy konstruktor dla klasy Logger dostarcza domyślne wartości dla filePath i level, czyniąc ją elastyczną i łatwą w użyciu, zachowując możliwość konfiguracji.
public interface IService
{
Distance GetDistance();
}
public class ExampleController(IService service) : ControllerBase
{
public ActionResult<Distance> Get() => service.GetDistance();
}Public Interface IService
Function GetDistance() As Distance
End Interface
Public Class ExampleController(IService service)
Inherits ControllerBase
Public Function [Get]() As ActionResult(Of Distance)
Return service.GetDistance()
End Function
End ClassPodstawowe konstruktory pasują do scenariuszy wstrzykiwania zależności. W tym przykładzie klasa kontrolera wskazuje swoje zależności, zwiększając łatwość utrzymania i ułatwiając testowanie jednostkowe.
public abstract class Shape(double width, double height)
{
public double Width { get; } = width;
public double Height { get; } = height;
public abstract double CalculateArea();
}
public class Rectangle(double width, double height) : Shape(width, height)
{
public override double CalculateArea() => Width * Height;
}
public class Circle : Shape
{
public Circle(double radius) : base(radius * 2, radius * 2) { }
public override double CalculateArea() => Math.PI * Math.Pow(Width / 2, 2);
}Public MustInherit Class Shape(Double width, Double height)
Public ReadOnly Property Width() As Double = width
Public ReadOnly Property Height() As Double = height
Public MustOverride Function CalculateArea() As Double
End Class
Public Class Rectangle(Double width, Double height)
Inherits Shape(width, height)
Public Overrides Function CalculateArea() As Double
Return Width * Height
End Function
End Class
Public Class Circle
Inherits Shape
Public Sub New(ByVal radius As Double)
MyBase.New(radius * 2, radius * 2)
End Sub
Public Overrides Function CalculateArea() As Double
Return Math.PI * Math.Pow(Width / 2, 2)
End Function
End ClassW tym przykładzie, podstawowy konstruktor w klasie Shape stanowi fundament dla hierarchii kształtów geometrycznych. Podklasy takie jak Rectangle i Circle wykorzystują podstawowy konstruktor dla spójnej inicjalizacji. Klasa Rectangle sama deklaruje podstawowy konstruktor i przekazuje przechwycone parametry podstawowego konstruktóra do klasy Shape. Klasa Circle pokazuje elastyczność, definiując swój konstruktor w całej klasie, a potem przekazując swoje parametry jako wartości domyślne dla konstruktóra Shape, używając słowa kluczowego base.
IronPDF to wszechstronna biblioteka C# umożliwiająca programistom łatwe tworzenie, manipulowanie i konwertowanie plików PDF. Niezależnie od tego, czy generujesz faktury, raporty czy jakiekolwiek inne dokumenty, IronPDF pozwala na bezproblemowe przekształcanie zawartości HTML w eleganckie i profesjonalne pliki PDF bezpośrednio w aplikacji C#.
IronPDF to przydatne narzędzie dla programistów pozwalające na zamianę stron internetowych, adresów URL i HTML na PDF. Najlepsze jest to, że pliki PDF wyglądają dokładnie jak oryginalne strony internetowe, z zachowanym całym formatowaniem i stylem. Jest idealne do tworzenia plików PDF z zawartości sieciowej, jak raporty i faktury.
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");
}
}Imports IronPdf
Friend Class Program
Shared Sub Main(ByVal args() As String)
Dim renderer = New ChromePdfRenderer()
' 1. Convert HTML String to PDF
Dim htmlContent = "<h1>Hello, IronPDF!</h1><p>This is a PDF from an HTML string.</p>"
Dim pdfFromHtmlString = renderer.RenderHtmlAsPdf(htmlContent)
pdfFromHtmlString.SaveAs("HTMLStringToPDF.pdf")
' 2. Convert HTML File to PDF
Dim htmlFilePath = "path_to_your_html_file.html" ' Specify the path to your HTML file
Dim pdfFromHtmlFile = renderer.RenderHtmlFileAsPdf(htmlFilePath)
pdfFromHtmlFile.SaveAs("HTMLFileToPDF.pdf")
' 3. Convert URL to PDF
Dim url = "http://ironpdf.com" ' Specify the URL
Dim pdfFromUrl = renderer.RenderUrlAsPdf(url)
pdfFromUrl.SaveAs("URLToPDF.pdf")
End Sub
End Class
Aby włączyć IronPDF do projektu C#, należy najpierw zainstalować pakiet IronPDF NuGet. W konsoli menedżera pakietów wykonaj następujące polecenie:
Alternatywnie, znajdź "IronPDF" w menedżerze pakietów NuGet i kontynuuj instalację stamtąd.
Tworzenie pliku PDF za pomocą IronPDF to usprawniony proces. Rozważmy następujący przykład:
var htmlContent = "<html><body><h1>Hello, IronPDF!</h1></body></html>";
// Create a new PDF document
var pdfDocument = new IronPdf.ChromePdfRenderer();
pdfDocument.RenderHtmlAsPdf(htmlContent).SaveAs("C:/GeneratedDocument.pdf");Dim htmlContent = "<html><body><h1>Hello, IronPDF!</h1></body></html>"
' Create a new PDF document
Dim pdfDocument = New IronPdf.ChromePdfRenderer()
pdfDocument.RenderHtmlAsPdf(htmlContent).SaveAs("C:/GeneratedDocument.pdf")W tym przykładzie wykorzystano IronPDF do renderowania treści HTML do dokumentu PDF, który następnie został zapisany w określonej lokalizacji. Aby uzyskać więcej informacji na temat tworzenia i manipulowania PDF w C#, odwiedź ten kompletny link do samouczka, a aby dowiedzieć się więcej, odwiedź tę stronę dokumentacji.
Konstruktory podstawowe C# oferują deklaratywne i uproszczone podejście do inicjalizacji właściwości klas bezpośrednio w deklaracji klasy. Przeanalizujmy, czy ta elegancka funkcja może być bezproblemowo zintegrowana z IronPDF.
Podczas gdy Podstawowe Konstruktory C# są głównie funkcją językową skupioną na inicjalizacji klas, ich bezpośrednia integracja z IronPDF może nie być powszechnym przypadkiem użycia. Rdzenna funkcjonalność IronPDF leży w generowaniu i manipulacji dokumentami PDF, a specyfika inicjalizacji klas może nie bezpośrednio współgrać z tym przepływem pracy.
Jednak programiści mogą wykorzystać Podstawowe Konstruktory C# przy definiowaniu niestandardowych klas lub struktur związanych z konfiguracjami lub modelami danych IronPDF. Na przykład, jeśli Twoja aplikacja wymaga konkretnej struktury klas do zarządzania ustawieniami lub konfiguracjami związanymi z PDF, Podstawowe Konstruktory C# mogą być cennym narzędziem do zwięzłej inicjalizacji tych klas.
public class PdfGenerationSettings(string title, bool includeHeader, bool includeFooter)
{
public string Title { get; } = title;
public bool IncludeHeader { get; } = includeHeader;
public bool IncludeFooter { get; } = includeFooter;
// Additional properties...
}
// Usage with IronPDF
var pdfSettings = new PdfGenerationSettings("My PDF Title", true, false);
var renderOptions = new ChromePdfRenderOptions
{
PaperSize = IronPdf.Rendering.PdfPaperSize.A4,
MarginTop = 20,
MarginBottom = 20,
MarginLeft = 10,
MarginRight = 10,
Title = pdfSettings.Title
};
// Apply settings from PdfGenerationSettings
if (pdfSettings.IncludeHeader)
{
renderOptions.TextHeader = new TextHeaderFooter
{
CenterText = "Page {page} of {total-pages}",
DrawDividerLine = true
};
}
var pdfDocument = new IronPdf.ChromePdfRenderer();
pdfDocument.RenderingOptions = renderOptions;
pdfDocument.RenderHtmlAsPdf("<html><body><h1>Hello, IronPDF!</h1></body></html>").SaveAs("CustomizedDocument.pdf");Public Class PdfGenerationSettings(String title, Boolean includeHeader, Boolean includeFooter)
Public ReadOnly Property Title() As String = title
Public ReadOnly Property IncludeHeader() As Boolean = includeHeader
Public ReadOnly Property IncludeFooter() As Boolean = includeFooter
' Additional properties...
End Class
' Usage with IronPDF
Private pdfSettings = New PdfGenerationSettings("My PDF Title", True, False)
Private renderOptions = New ChromePdfRenderOptions With {
.PaperSize = IronPdf.Rendering.PdfPaperSize.A4,
.MarginTop = 20,
.MarginBottom = 20,
.MarginLeft = 10,
.MarginRight = 10,
.Title = pdfSettings.Title
}
' Apply settings from PdfGenerationSettings
If pdfSettings.IncludeHeader Then
renderOptions.TextHeader = New TextHeaderFooter With {
.CenterText = "Page {page} of {total-pages}",
.DrawDividerLine = True
}
End If
Dim pdfDocument = New IronPdf.ChromePdfRenderer()
pdfDocument.RenderingOptions = renderOptions
pdfDocument.RenderHtmlAsPdf("<html><body><h1>Hello, IronPDF!</h1></body></html>").SaveAs("CustomizedDocument.pdf")W tym przykładzie klasa PdfGenerationSettings wykorzystuje Podstawowy Konstruktor C# do inicjalizacji właściwości związanych z ustawieniami generowania PDF, które mogą być później wykorzystane do określenia, które opcje renderowania dodać, a które pominąć. Wydruk zawiera tekst nagłówka i tytuł, jak został ustawiony za pomocą parametru podstawowego konstruktóra.
Podsumowując, Podstawowe Konstruktory w C# oferują udoskonalone i ekspresyjne podejście do inicjalizacji klas. Ich deklaratywna składnia poprawia czytelność kodu, promuje niezmienność i upraszcza proces tworzenia obiektów z domyślnymi wartościami. Niezależnie od tego, czy definiujesz właściwości, wymuszasz niezmienność, czy korzystasz z domyślnych wartości, Podstawowe Konstruktory dają programistom możliwość opanowania sztuki inicjalizacji klas w dynamicznym świecie programowania C#.
Podczas gdy bezpośrednia integracja Podstawowych Konstruktorów C# z IronPDF może nie być głównym celem, te dwa elementy mogą harmonijnie współpracować. Podstawowe Konstruktory C# zwiększają jasność i prostotę inicjalizacji klas, czyniąc je wartościowymi do definiowania struktur lub konfiguracji związanych z przepływami pracy IronPDF.
Wykorzystaj moc IronPDF do solidnego generowania PDF i stosuj Podstawowe Konstruktory C#, tam gdzie elegancja inicjalizacji klas jest nadrzędna. Ta dynamiczna para umożliwia nawigację w skomplikowanym procesie generowania dokumentów z kreatywnością i wydajnością w tętniącym życiu świecie programowania C#.
IronPDF oferuje bezpłatny okres próbny, a jego licencja lite zaczyna się od $999.
Jacob Mellor jest Chief Technology Officer w Iron Software i wizjonerskim inżynierem, pionierem technologii C# PDF. Jako pierwotny deweloper głównej bazy kodowej Iron Software, kształtuje architekturę produktów firmy od jej początku, przekształcając ją wspólnie z CEO Cameron Rimington w firmę liczącą ponad 50 osób, obsługującą NASA, Teslę i światowe agencje rządowe.
IronPDF jest częścią IRONSUITE
10 produktów API .NET dla twoich dokumentów biurowych
Kiedy potrzebujesz, aby twój PDF wyglądał jak HTML, szybko.
