Słowo kluczowe C# ref jest niezbędnym narzędziem, o którym powinien nauczyć się każdy początkujący. Uzywane jest do przekazywania argumentow przez referencje, a nie przez wartosc, co pozwala na odzwierciedlenie zmian dokonanych na zmiennej typu referencyjnego w wewnątrz wywolywanej metody poza nia. W tym samouczku przejrzymy szczegóły slowa kluczowego ref i zbadamy różne przykłady kodu konsolowego, ktore ilustruja, jak ono działa.
Gdy przekazujesz parametr metody w C#, domyslnie jest on przekazywany przez wartosc. Oznacza to, ze tworzona jest kopia wartosci parametru, a wszelkie zmiany dokonane w wewnątrz wywolywanej metody nie wpływają na oryginalna zmienna poza metoda. Słowo kluczowe ref zmienia to zachowanie, pozwalając na przekazanie parametru przez odwołanie. Gdy parametr jest przekazywany przez referencje, wszelkie zmiany dokonane w wewnątrz metody bezpośrednio wpływają na oryginalna zmienna poza metoda.
ref: Używane do wskazania, że zmienna jest przekazywana przez odwołanie.ref.Zacznijmy od zrozumienia koncepcji, jak zmienne sa przekazywane przez referencje. Wyobraz sobie, ze masz metode, która zwieksza liczbe całkowita, jak pokazano w poniższym kodzie:
class Program
{
// Method increments the given integer by one
static void IncrementByOne(int num)
{
num++;
}
static void Main()
{
int value = 5;
IncrementByOne(value);
Console.WriteLine(value); // Output: 5
}
}Friend Class Program
' Method increments the given integer by one
Private Shared Sub IncrementByOne(ByVal num As Integer)
num += 1
End Sub
Shared Sub Main()
Dim value As Integer = 5
IncrementByOne(value)
Console.WriteLine(value) ' Output: 5
End Sub
End ClassW powyższym kodzie, mimo że zwiększyliśmy num w obrębie metody IncrementByOne, oryginalna value pozostała niezmieniona. Dzieje się tak, ponieważ num jest kopią oryginalnej zmiennej, a zmiany w niej dokonywane nie wpływają na oryginał.
Zobaczmy teraz, jak słowo kluczowe ref może zmienić to zachowanie. Używając ref, można przekazać zmienną przez odwołanie do metody, jak pokazano w jednym z poniższych przykładów kodu.
class Program
{
// Method increments the given integer by one using ref
static void IncrementByOneRef(ref int num)
{
num++;
}
static void Main()
{
int value = 5;
IncrementByOneRef(ref value);
Console.WriteLine(value); // Output: 6
}
}Friend Class Program
' Method increments the given integer by one using ref
Private Shared Sub IncrementByOneRef(ByRef num As Integer)
num += 1
End Sub
Shared Sub Main()
Dim value As Integer = 5
IncrementByOneRef(value)
Console.WriteLine(value) ' Output: 6
End Sub
End ClassZauważ słowo kluczowe ref zarówno w sygnaturze metody, jak i w wywołaniu. To mówi C#, że chcesz przekazać zmienną value przez odwołanie. W rezultacie zmiany dokonane w obrębie metody IncrementByOneRef są odzwierciedlone w oryginalnej zmiennej value.
Słowo kluczowe ref jest szczególnie przydatne podczas pracy z typami takimi jak liczba całkowita, double i structs. Te typy sa przechowywane bezpośrednio w pamięci, i przekazywanie ich przez referencje może prowadzić do poprawy wydajności oraz bardziej precyzyjnej kontroli nad manipulacją danymi.
Chociaż słowo kluczowe ref jest powszechnie kojarzone z typami wartości, można je również używać z zmiennymi typu referencyjnego. Typy referencyjne, takie jak klasy i tablice, przechowują referencje do rzeczywistych danych w pamięci, a nie same dane. Oznacza to, ze masz do czynienia z struktura przypominajaca wskaźnik, a przekazywanie przez referencje może przynosic inne wyniki, jak pokazano w poniższym przykładzie:
class Person
{
public string Name { get; set; }
}
class Program
{
// Method changes the reference of the person variable to a new Person object
static void ChangeName(ref Person person)
{
person = new Person { Name = "Alice" };
}
static void Main()
{
Person person = new Person { Name = "Bob" };
ChangeName(ref person);
Console.WriteLine(person.Name); // Output: Alice
}
}Friend Class Person
Public Property Name() As String
End Class
Friend Class Program
' Method changes the reference of the person variable to a new Person object
Private Shared Sub ChangeName(ByRef person As Person)
person = New Person With {.Name = "Alice"}
End Sub
Shared Sub Main()
Dim person As New Person With {.Name = "Bob"}
ChangeName(person)
Console.WriteLine(person.Name) ' Output: Alice
End Sub
End ClassW tym przykładzie metoda ChangeName zmienia odwołanie zmiennej person na nowy obiekt Person. W rezultacie oryginalna zmienna person teraz wskazuje na inny obiekt, a jego nazwa to "Alice".
Możesz mieć wiele metod o tej samej nazwie, ale innych parametrach. To nazywa się przeladowaniem metody. Gdy używasz słowa kluczowego ref, przeciążanie metod staje się bardziej potężne.
class Calculator
{
// Method adds two integers and modifies the first using ref
public static void Add(ref int x, int y)
{
x += y;
}
// Method adds two doubles and modifies the first using ref
public static void Add(ref double x, double y)
{
x += y;
}
}
class Program
{
static void Main()
{
int intValue = 5;
double doubleValue = 7.5;
// Call overloaded Add methods with ref parameters
Calculator.Add(ref intValue, 3);
Calculator.Add(ref doubleValue, 2.5);
Console.WriteLine(intValue); // Output: 8
Console.WriteLine(doubleValue); // Output: 10.0
}
}Friend Class Calculator
' Method adds two integers and modifies the first using ref
Public Shared Sub Add(ByRef x As Integer, ByVal y As Integer)
x += y
End Sub
' Method adds two doubles and modifies the first using ref
Public Shared Sub Add(ByRef x As Double, ByVal y As Double)
x += y
End Sub
End Class
Friend Class Program
Shared Sub Main()
Dim intValue As Integer = 5
Dim doubleValue As Double = 7.5
' Call overloaded Add methods with ref parameters
Calculator.Add(intValue, 3)
Calculator.Add(doubleValue, 2.5)
Console.WriteLine(intValue) ' Output: 8
Console.WriteLine(doubleValue) ' Output: 10.0
End Sub
End ClassW powyższym przykładzie przeciążamy metodę Add, aby działała zarówno z typami int, jak i double. Słowo kluczowe ref pozwala metodom na bezpośrednią modyfikację oryginalnych zmiennych.
Kolejne związane słowo kluczowe to out. Jest podobne do ref, ale ma nieco inny cel. Podczas gdy ref oczekuje, że zmienna będzie zainicjalizowana przed przekazaniem, słowo kluczowe out jest używane, gdy chcesz, aby metoda przypisała wartość do parametru, który nie musi mieć wartości początkowej:
class Program
{
// Method computes the quotient and uses the out keyword to return it
static void Divide(int dividend, int divisor, out int quotient)
{
quotient = dividend / divisor;
}
static void Main()
{
int result;
Divide(10, 2, out result);
Console.WriteLine(result); // Output: 5
}
}Friend Class Program
' Method computes the quotient and uses the out keyword to return it
Private Shared Sub Divide(ByVal dividend As Integer, ByVal divisor As Integer, ByRef quotient As Integer)
quotient = dividend \ divisor
End Sub
Shared Sub Main()
Dim result As Integer = Nothing
Divide(10, 2, result)
Console.WriteLine(result) ' Output: 5
End Sub
End ClassW tym przykładzie metoda Divide oblicza iloraz i przypisuje go do zmiennej quotient, używając słowa kluczowego out. Warto zauważyć, że nie trzeba inicjalizować result przed przekazaniem go do metody.
Słowo kluczowe out jest podobne do słowa kluczowego ref, ale znacząco różne. Parametr out nie wymaga początkowej wartości, natomiast parametr ref musi mieć początkową wartość przed wywołaniem metody.
Chociaż słowa kluczowe ref i out mogą być potężnymi narzędziami, należy ich używać rozważnie. Niepoprawne użycie tych slow może prowadzic do niejasnego kodu i nieoczekiwanego zachowania. Na przykład nie można używać zmiennej nie-ref w parametrze ref lub out bez wcześniejszego jej zainicjalizowania, ponieważ prowadziłoby to do błędu kompilacji.
Zrozumienie różnicy między typami referencyjnymi a typami wartości jest kluczowe podczas pracy ze słowem kluczowym ref.
Użycie ref z typami wartości pozwala na odzwierciedlenie zmian poza metodą, podczas gdy zmienne typu referencyjnego z natury zachowują się w ten sposób.
Można także używać słowa kluczowego ref z metodami rozszerzającymi. Przykład:
public static class StringExtensions
{
// Extension method that appends a value to the input string
public static void AppendValue(ref this string input, string value)
{
input += value;
}
}Public Module StringExtensions
' Extension method that appends a value to the input string
Public Sub AppendValue(ByRef Me input As String, ByVal value As String)
input &= value
End Sub
End ModuleJeśli zapomnisz dodać słowo kluczowe ref w sygnaturze metody lub w wywołaniu metody, spowoduje to błąd kompilatora w czasie kompilacji.
Async i parametry refZwróć uwagę, że nie można używać parametrów ref z metodami iterującymi ani metodami async, ponieważ te wymagają przekazywania parametru przez wartość.
Oprócz zrozumienia kluczowych pojęć, takich jak słowo kluczowe ref w C#, istnieje zestaw potężnych narzędzi, które mogą znacznie ułatwić życie programisty. Iron Suite to zestaw wytrzymałych narzędzi i bibliotek, które obejmują IronPDF, IronXL, IronOCR oraz IronBarcode. Przyjrzyjmy się tym narzędziom i zobaczmy, jak mogą one ułatwic twoje doświadczenie w programowaniu bez zadnej argumentacji.
Dowiedz się o IronPDF jako niezbędnej części Iron Suite. Jest to biblioteka, która umożliwia programistom tworzenie, odczytywanie i edytowanie plików PDF w C#. Jeśli chcesz zamienić HTML na PDF, IronPDF ma potrzebne Ci narzędzia. Sprawdź samouczek o konwersji HTML na PDF aby dowiedzieć się więcej o tej funkcji.
Praca z plikami Excel w C# może być wyzwaniem, ale funkcje IronXL upraszczają to zadanie. Umożliwia odczytywanie, zapis, edytowanie i manipulowanie plikami Excel bez konieczności instalacji Excela. Od importowania danych po tworzenie nowych arkuszy kalkulacyjnych, IronXL ułatwia obsługę Excela w C#.
Rozpoznawanie znaków optycznych (OCR) może być skomplikowane, ale odkryj IronOCR aby uprościć ten proces. Dzięki tej bibliotece, możesz odczytać tekst z obrazków i zamienić go na tekst maszynowy. Jeśli potrzebujesz wyodrębnić tekst z zeskanowanego dokumentu lub rozpoznać znaki z obrazu, IronOCR posiada funkcjonalność, aby pomóc.
Kody kreskowe są powszechnie używane w różnych branżach, a ich obsługa w Twoich aplikacjach jest teraz łatwiejsza dzięki bibliotece IronBarcode. Ta biblioteka pozwala tworzyć, odczytywać i pracować z kodami kreskowymi w C#. IronBarcode obsługuje szeroką gamę formatów QR i Barcode.
Możesz się zastanawiać, w jaki sposób te narzędzia są powiązane ze słowem kluczowym ref, o którym rozmawialiśmy. Podczas pracy nad skomplikowanymi projektami związanymi z plikami PDF, Excel, OCR lub kodami kreskowymi, skuteczne wykorzystanie słowa kluczowego ref i innych zasad C# będzie kluczowe dla efektywnego zarządzania kodem.
Na przykład, manipulując dużymi plikami Excel przy pomocy IronXL, przekazywanie obiektów przez odwołanie za pomocą słowa kluczowego ref może uczynić kod bardziej efektywnym i łatwiejszym do utrzymania. Podobnie, pracując z dokumentami PDF przy użyciu IronPDF, mogą być zastosowane metody, przy których słowo kluczowe ref może odgrywać rolę.
Zrozumienie podstawowych cech języka, takich jak słowo kluczowe ref, oraz dostęp do narzędzi takich jak Iron Suite, wyposażają cię w potężne połączenie do budowy efektywnych, solidnych i wszechstronnych aplikacji. Iron Suite jest zaprojektowany, aby działać bezproblemowo z Twoją obecną wiedzą o C#, a razem pomogą Ci tworzyć bardziej profesjonalne i wyrafinowane rozwiązania.
Język C#, z funkcjami takimi jak słowo kluczowe ref, oferuje potężne możliwości dla programistów. Połączone z Iron Suite, w tym IronPDF, IronXL, IronOCR i IronBarcode, możliwości stają się jeszcze bardziej rozległe.
Każdy produkt w Iron Suite oferuje darmową wersję próbną, pozwalając Ci na eksplorację i wykorzystanie rozleglych funkcjonalności bez żadnej natychmiastowej inwestycji. Jeśli zdecydujesz się na pełną licencję, ceny zaczynają się od $999 za poszczególne komponenty.
Jeśli uważasz, że cała Iron Suite spełnia Twoje potrzeby, czeka Cię doskonała oferta. Możesz nabyć pełny zestaw po cenie odpowiadającej zaledwie dwóm poszczególnym komponentom.
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.
