Wyświetlanie i zmienianie wartości zmiennych za pomocą etykietek danych w edytorze kodu
W tym artykule opisano sposób pracy z funkcją DataTips w programie Visual Studio. Porady dotyczące danych zapewniają wygodny sposób wyświetlania informacji o zmiennych w programie podczas debugowania kodu. Po ustawieniu punktów przerwania w kodzie i rozpoczęciu debugowania porady dotyczące danych są widoczne dla zmiennych podczas wprowadzania bieżącego zakresu wykonywania. Możesz użyć porady dotyczącej danych, aby zmienić wartość zmiennej w zakresie i ponownie uruchomić kod w punkcie przerwania, aby zobaczyć efekt zmiany.
Napiwek
Jeśli dopiero zaczynasz debugować, możesz przeczytać artykuł Debugowanie dla początkujących i technik debugowania oraz narzędzi przed rozpoczęciem pracy z tym artykułem.
Wymagania wstępne
Visual Studio. Jeśli nie masz programu Visual Studio, przejdź do strony pobierania programu Visual Studio, aby zainstalować ją bezpłatnie.
Niektóre kod programu do uruchomienia w debugerze programu Visual Studio.
Praca z poradami dotyczącymi danych
Porady dotyczące danych są widoczne podczas sesji debugowania po ustawieniu punktów przerwania w kodzie. Gdy debuger wstrzymuje wykonywanie programu w punkcie przerwania, porady dotyczące danych są dostępne dla dowolnych zmiennych w bieżącym zakresie.
Proces jest następujący:
Ustaw punkt przerwania w kodzie i rozpocznij debugowanie, wybierając pozycję Debuguj>rozpocznij debugowanie lub użyj skrótu klawiaturowego F5.
Gdy debuger wstrzymuje wykonywanie w punkcie przerwania, umieść kursor na dowolnej zmiennej w bieżącym zakresie, aby otworzyć poradę dotyczącą danych.
Skorzystaj z porad dotyczących danych, aby wyświetlić nazwę zmiennej i pracować z wartością.
W razie potrzeby zmień wartość zmiennej lub dodaj komentarze.
Uwaga
Program Visual Studio ocenia i wyświetla wartość zmiennej w poradzie danych na podstawie kontekstu, w którym debuger jest wstrzymany podczas wykonywania. Ocena nie jest oparta na bieżącej lokalizacji kursora ani porady dotyczącej danych. Jeśli zatrzymasz wskaźnik myszy na zmiennej w innej funkcji, która ma taką samą nazwę jak zmienna w bieżącym kontekście, program Visual Studio wyświetli wartość zmiennej w poradzie danych dla bieżącego kontekstu.
Program Visual Studio obsługuje wiele akcji dotyczących porad dotyczących danych i pracy ze zmiennymi i wartościami, w tym:
- Przypnij lub zmiennoprzecinkową wskazówkę danych, aby zachować jej widoczność w miarę kontynuowania wykonywania kodu
- Włącz przyklejone porady dotyczące danych, które pozostają rozwinięte, dopóki nie wybierzesz innego miejsca
- Rozwiń poradę dotyczącą danych dla tablicy, struktury lub obiektu, aby wyświetlić jego elementy członkowskie w formacie drzewa
- Zmienianie wartości zmiennej w poradzie dotyczącej danych
- Dodawanie komentarzy wielowierszowych do przypiętej porady dotyczącej danych w celu zanotowania podczas debugowania
- Porady dotyczące importowania i eksportowania danych
Przezroczyste wskazówki dotyczące danych
Po umieszczeniu wskaźnika myszy na zmiennej, aby wyświetlić poradę dotyczącą danych, możesz ustawić poradę dotyczącą danych jako przezroczystą, aby zobaczyć kod pod spodem. Ta akcja włącza również przezroczystość innych akcji porad w edytorze kodu, takich jak definicje metod i składnia wyrażeń.
Aby włączyć przejrzystość, wykonaj następujące kroki:
W edytorze programu Visual Studio Code wybierz wewnątrz poradę dotyczącą danych, a następnie naciśnij i przytrzymaj Ctrl.
Aby zachować przezroczystość, przytrzymaj Ctrl.
Aby zakończyć przezroczystość, przestań zaznaczać Ctrl lub wybierać gdzie indziej.
Przezroczystość nie jest dostępna dla przypiętej lub przestawnej końcówki danych.
Zachowaj rozwinięte porady dotyczące danych
W programie Visual Studio 2022 Update 1 lub nowszym po rozwinięciu porady dotyczącej danych można zachować rozszerzenie do momentu wybrania innego miejsca. Ta akcja generuje lepką poradę dotyczącą danych.
Aby utworzyć lepką wskazówkę dotyczącą danych, wykonaj następujące kroki:
W programie Visual Studio wybierz pozycję Opcje debugowania>, aby otworzyć okno dialogowe Opcje.
Na karcie Ogólne przewiń w celu zlokalizowania opcji Zachowaj rozwinięte dane otwarte, dopóki nie klikniesz opcji.
Zaznacz pole wyboru, aby włączyć opcję przyklejoną, a następnie wybierz przycisk OK.
Jeśli opcja sticky jest włączona, po rozwinięciu jakiejkolwiek porady dotyczącej danych w edytorze kodu pozostanie ona rozwinięta.
Przypinanie porad dotyczących danych
Możesz przypiąć poradę dotyczącą danych, aby zachować ją otwartą na powierzchni edytora kodu. Możesz również zmienić lokalizację przypiętej końcówki danych.
Aby przypiąć poradę dotyczącą danych, wykonaj następujące kroki:
W edytorze programu Visual Studio Code umieść kursor na zmiennej, aby wyświetlić poradę dotyczącą danych.
W poradzie danych użyj pinezki, aby wybrać pozycję Przypnij do źródła:
Program Visual Studio przypina wskazówkę danych do miejsca znajdującego się w pobliżu zmiennej na powierzchni kodu. Pinezka jest wyświetlana w rynnie edytora kodu obok wiersza, w którym przypięta jest porada dotycząca danych.
Zaznacz i przeciągnij przypiętą wskazówkę danych do dowolnej lokalizacji na powierzchni edytora kodu.
Porady dotyczące danych zmiennoprzecinkowych (odpięć)
Po przypiętym wskazówce danych możesz odpiąć poradę dotyczącą danych i ustawić ją jako zmienną. Zmienna porada danych może być umieszczona w dowolnym miejscu w środowisku IDE programu Visual Studio.
Aby unosić poradę dotyczącą danych, wykonaj następujące kroki:
W przypiętej wskazówce danych użyj pinezki, aby wybrać pozycję Odepnij ze źródła.
Program Visual Studio odpina poradę dotyczącą danych i daje poradę o stałym kolorze. Wypchnięcie porady danych zmieni się na odpiętą pozycję, a wypchnięcie w rynnie edytora kodu zostanie usunięte.
Wybierz i przeciągnij zmienną wskazówkę danych do dowolnej lokalizacji w środowisku IDE programu Visual Studio.
Jeśli umieścisz zmienną wskazówkę danych poza powierzchnią edytora kodu, pinezki zostaną usunięte z menu po stronie porady danych. Opcja Przypnij do źródła jest dostępna tylko wtedy, gdy zmienna porada danych jest umieszczona na powierzchni edytora kodu.
Porady dotyczące danych repozytorium
Po upłynięciu porad dotyczących danych można je ponownie powtórzyć do określonej lokalizacji źródłowej na powierzchni edytora kodu.
Aby ponownie utworzyć przestawną poradę dotyczącą danych, wykonaj następujące kroki:
Wybierz i przenieś zmienną wskazówkę danych i umieść ją na powierzchni edytora kodu.
W przestawnym napiwku danych użyj pinezki, aby wybrać pozycję Przypnij do źródła.
Pinezka zmienia się na przypiętą pozycję. Porada dotycząca danych jest repinned do określonej lokalizacji w edytorze kodu, a pushpin dla źródła pojawia się w rynnach edytora kodu.
Zamykanie porad dotyczących danych
Istnieje kilka sposobów zamykania porad dotyczących danych w programie Visual Studio.
Po zakończeniu sesji debugowania, jeśli masz jakiekolwiek otwarte porady dotyczące danych, program Visual Studio zamyka je za Ciebie. Jeśli uruchomisz kolejną sesję debugowania, program Visual Studio spróbuje ponownie opublikować wszelkie wskazówki dotyczące danych, które wcześniej pozostawiono otwarte.
Poniższa tabela zawiera podsumowanie sposobu ręcznego zamykania porad dotyczących danych:
| Zamknij element docelowy | Akcja |
|---|---|
| Konkretna porada dotycząca danych | Wybierz znak X w poradzie o danych. |
| Wszystkie porady dotyczące danych dla określonego pliku | Wybierz pozycję Debuguj>wyczyść wszystkie etykietki danych przypięte do <nazwy pliku> na pasku narzędzi programu Visual Studio. |
| Wszystkie otwarte porady dotyczące danych | Wybierz pozycję Debuguj>wyczyść wszystkie etykietki danych na pasku narzędzi programu Visual Studio. |
Praca ze zmiennymi i wartościami w poradach dotyczących danych
Podczas pracy z etykietkami danych w programie Visual Studio uzyskujesz możliwość wyświetlania szczegółowych informacji o zmiennych i obiektach oraz edytowania wartości podczas debugowania. Te możliwości są przydatne do szybkiego rozwiązywania problemów i testowania zmian w kodzie.
Rozwijanie obiektów w poradach dotyczących danych w celu wyświetlenia elementów członkowskich
Gdy porada dotycząca danych reprezentuje tablicę, strukturę lub obiekt, możesz rozwinąć widok porad dotyczących danych, aby wyświetlić elementy członkowskie. Widok rozwinięty przedstawia dodatkowe informacje w formacie drzewa hierarchicznego.
Aby rozwinąć widok obiektu w poradzie dotyczącej danych, wykonaj następujące kroki:
W poradzie danych dla tablicy, struktury lub obiektu wybierz strzałkę rozwijania przed nazwą elementu, aby wyświetlić elementy członkowskie. Widok jest prezentowany w formacie drzewa:
W przypadku przypiętej końcówki danych wybierz symbol plus (+) przed nazwą zmiennej, aby rozwinąć definicję.
Wybierz strzałki rozwijania, aby wyświetlić więcej hierarchii elementów członkowskich:
Aby przejść w górę i w dół w widoku rozwiniętym, użyj myszy lub klawiatury w górę i w dół.
Aby przypiąć rozwinięty element członkowski z oryginalną przypiętą poradą dotyczącą danych, użyj pinezki na elemencie członkowskim, aby wybrać pozycję Przypnij do źródła. Po zwinięciu widoku drzewa wszystkie przypięte elementy członkowskie pozostaną widoczne na przypiętej wskazówce danych.
Edytowanie wartości zmiennych
Kolejną zaletą pracy z etykietkami danych jest możliwość edytowania wartości zmiennej lub elementu w poradzie danych podczas debugowania. Ta funkcja jest przydatna do szybkiego testowania małych zmian w kodzie.
Aby edytować wartość zmiennej lub elementu w poradzie danych, wykonaj następujące kroki:
W poradzie na temat danych wybierz wartość. Program Visual Studio wyróżnia wartość i udostępnia ją do edycji.
Wprowadź nową wartość w poradzie o danych i wybierz Enter.
Należy pamiętać, że niektóre wartości zmiennych są tylko do odczytu. Program Visual Studio nie udostępnia wartości tylko do odczytu do edycji.
Używanie komentarzy w poradach dotyczących danych
Obszar Komentarze w poradzie dotyczącej danych jest przydatny do utrzymywania notatek dotyczących zmiennych podczas debugowania kodu. Ten region jest wygodnym miejscem do śledzenia różnych wartości podczas debugowania. Komentarze można dodawać w przypiętej lub przestawnej wskazówce danych.
Aby użyć komentarzy w poradzie o danych, wykonaj następujące kroki:
W poradzie danych użyj podwójnej strzałki w dół, aby wybrać pozycję Rozwiń, aby wyświetlić komentarz. Podwójna strzałka w dół otwiera obszar Komentarze w poradzie o danych, w którym można dodać notatki.
Aby dodać komentarz, wstaw kursor w regionie Komentarze i wprowadź tekst. Region akceptuje wiele wierszy.
Aby zamknąć region Komentarze, użyj podwójnej strzałki w górę, aby zwinąć komentarze. Wszelkie wprowadzone komentarze pozostają z poradą dotyczącą danych, ale nie są one obecnie widoczne.
Przypinanie właściwości w poradach dotyczących danych
Program Visual Studio obsługuje przypinanie właściwości w przypiętych poradach dotyczących danych w programie .NET Core 3.0 lub nowszym. Ta funkcja umożliwia szybkie sprawdzanie obiektów według ich właściwości w poradach dotyczących danych.
Aby przypiąć właściwości w poradach dotyczących danych, wykonaj następujące kroki:
W przypiętej wskazówce danych rozwiń hierarchię elementów członkowskich, dopóki nie zobaczysz właściwości, która ma być widoczna za pomocą porady o danych.
Użyj pinezki dla właściwości , aby przypiąć ją z poradą dotyczącą danych. Możesz również kliknąć prawym przyciskiem myszy właściwość i wybrać polecenie Przypnij element członkowski jako ulubiony.
Program Visual Studio przenosi wybraną właściwość na górę listy właściwości obiektu. Nazwa właściwości i wartość są wyświetlane w prawej kolumnie przypiętej porady danych:
Aby odpiąć właściwość w poradzie danych, wybierz ponownie przypięcie dla właściwości lub kliknij prawym przyciskiem myszy właściwość i wybierz polecenie Odepnij element członkowski jako ulubiony.
Możesz również przełączać widoczność nazw właściwości i filtrować odpięte właściwości na liście właściwości obiektu w poradzie danych:
Aby odfiltrować odpięte właściwości, kliknij prawym przyciskiem myszy wiersz właściwości w poradzie danych i wybierz polecenie Pokaż tylko przypiętych członków.
Aby przełączyć widoczność nazw właściwości, kliknij prawym przyciskiem myszy wiersz właściwości w poradzie danych i wybierz polecenie Ukryj przypięte nazwy elementów członkowskich w wartościach.
Na poniższej ilustracji przedstawiono różne opcje w menu prawym przyciskiem myszy dla hierarchii elementów członkowskich w poradzie dotyczącej danych:
Uzyskiwanie pomocy dotyczącej sztucznej inteligencji
Jeśli masz copilot, możesz uzyskać pomoc dotyczącą sztucznej inteligencji podczas przeglądania zmiennych w poradach dotyczących danych. Kliknij prawym przyciskiem myszy zmienną i użyj przycisku Zapytaj Copilot
. W tym scenariuszu Copilot zna już kontekst pytania, więc nie musisz podawać kontekstu na czacie. Aby uzyskać więcej informacji, zobacz Debugowanie za pomocą narzędzia Copilot.
Wizualizowanie złożonych typów danych
Wizualizatory wyświetlają informacje w bardziej zrozumiały, a czasami graficzny sposób. Przykłady wizualizatorów to XML, HTML, JSON i Wizualizator tekstu. Wizualizacje umożliwiają badanie złożonych typów danych w kodzie podczas debugowania.
Jeśli wizualizatory są dostępne dla elementu, program Visual Studio wyświetla lupę Widok obok nazwy elementu w poradzie danych. Po wybraniu wizualizacji program Visual Studio otworzy oddzielne okno, aby wyświetlić złożone dane w formacie czytelnym.
Za pomocą tej funkcji można wybrać wizualizację danych:
Aby wyświetlić element przy użyciu domyślnego wizualizatora dla typu danych, wybierz lupę.
Aby wybrać określony wizualizator, rozwiń listę rozwijaną Widok obok lupy i wybierz opcję.
Dodawanie zmiennych do okien kontrolnych
Możesz nadal obserwować zmienne, dodając je do okna zegarka programu Visual Studio z poradą dotyczącą danych:
- W poradzie danych kliknij prawym przyciskiem myszy nazwę zmiennej i wybierz polecenie Dodaj zegarek.
Program Visual Studio dodaje zmienną w oknie Obserwowanie. Jeśli wersja programu Visual Studio obsługuje wiele okien watch , zmienna zostanie wyświetlona w oknie z etykietą Watch 1.
Porady dotyczące importowania i eksportowania danych
Możesz wyeksportować porady dotyczące danych do pliku XML, który można udostępniać lub edytować za pomocą edytora tekstów. Możesz również zaimportować porady dotyczące danych z otrzymanego lub wcześniej edytowanego pliku XML.
Aby wyeksportować porady dotyczące danych, wykonaj następujące kroki:
W programie Visual Studio wybierz pozycję Debuguj>eksportuj etykietki danych. Zostanie otwarte okno dialogowe Eksportowanie etykietek danych.
W oknie dialogowym przejdź do lokalizacji, w której chcesz zapisać plik XML.
Wprowadź nazwę pliku eksportu, a następnie wybierz pozycję Zapisz.
Program Visual Studio eksportuje porady dotyczące danych do określonego pliku i lokalizacji.
Aby zaimportować porady dotyczące danych z pliku, wykonaj następujące kroki:
W programie Visual Studio wybierz pozycję Debuguj>importuj etykietki danych. Zostanie otwarte okno dialogowe Importowanie etykietek danych.
W oknie dialogowym przejdź do lokalizacji pliku XML porad dotyczących danych, który ma być używany do importowania.
Wybierz plik do otwarcia, a następnie wybierz pozycję Otwórz.
Program Visual Studio importuje porady dotyczące danych z określonego pliku do bieżącego obszaru roboczego. Podczas debugowania kodu obszaru roboczego dostępne są zaimportowane porady dotyczące danych.