Wyświetlanie wartości danych w obszarze Dane Wskazówki w edytorze kodu

Porady dotyczące danych zapewniają wygodny sposób wyświetlania informacji o zmiennych w programie podczas debugowania. Porady dotyczące danych działają tylko w trybie przerwania i tylko ze zmiennymi, które znajdują się w bieżącym zakresie wykonywania. Jeśli po raz pierwszy próbowano debugować kod, warto przeczytać artykuł Debugowanie dla początkujących i technik debugowania oraz narzędzi przed przejściem do tego artykułu.

Praca z poradami dotyczącymi danych

Porady dotyczące danych są wyświetlane tylko w trybie przerwania i tylko w zmiennych, które znajdują się w bieżącym zakresie wykonywania.

Wyświetlanie porady o danych

  1. Ustaw punkt przerwania w kodzie i rozpocznij debugowanie, naciskając klawisz F5 lub wybierając pozycję Debuguj>Rozpocznij debugowanie.

  2. Po wstrzymaniu w punkcie przerwania umieść kursor na dowolnej zmiennej w bieżącym zakresie. Zostanie wyświetlona porada dotycząca danych z nazwą i bieżącą wartością zmiennej.

Przezroczyste tworzenie porad dotyczących danych

Aby ustawić przezroczystość porad dotyczących danych, aby zobaczyć kod, który znajduje się pod nim, podczas gdy w poradzie danych naciśnij klawisze Ctrl. Wskazówka dotycząca danych pozostaje przezroczysta, o ile przytrzymaj naciśnięty klawisz Ctrl . Nie działa to w przypadku przypiętych ani przestawnych wskazówek dotyczących danych.

Zachowaj rozwiniętą poradę dotyczącą danych

Począwszy od programu Visual Studio 2022 Update 1, po rozwinięciu porady dotyczącej danych można ją zachować, dopóki nie klikniesz gdzie indziej. Jest to nazywane lepką poradą dotyczącą danych. Aby włączyć tę funkcję, wybierz pozycję Narzędzia>Opcje>Debugowanie, a następnie na karcie Ogólne wybierz pozycję Zachowaj rozwinięte porady dotyczące danych otwarte do momentu kliknięcia.

Przypnij poradę dotyczącą danych

Aby przypiąć poradę dotyczącą danych tak, aby była otwarta, wybierz ikonę pinezki przypnij do źródła .

Pin a data tip

Możesz przenieść przypiętą poradę dotyczącą danych, przeciągając ją wokół okna kodu. Ikona pinezki jest wyświetlana w rynnie obok wiersza, do których jest przypięta porada danych.

Uwaga

Porady dotyczące danych są zawsze oceniane w kontekście, w którym wykonywanie jest zawieszone, a nie bieżąca lokalizacja kursora lub porady 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, zostanie wyświetlona wartość zmiennej w bieżącym kontekście.

Odepnij poradę dotyczącą danych ze źródła

Aby umieścić przypiętą poradę dotyczącą danych, umieść kursor nad poradą dotyczącą danych i wybierz ikonę pushpin z menu kontekstowego.

Ikona pinezki zmienia się na odpiętą pozycję, a porada danych teraz un floats lub może zostać przeciągnięta nad wszystkimi otwartymi oknami. Przestawne porady dotyczące danych są zamykane po zakończeniu sesji debugowania.

Repin a data tip (Repin a data tip)

Aby ponownie utworzyć przestawną poradę dotyczącą danych do źródła, umieść kursor nad nim w edytorze kodu i wybierz ikonę pushpin. Ikona pinezki zmienia się na przypiętą pozycję, a porada dotycząca danych jest ponownie przypięta tylko do okna kodu.

Jeśli porada dotycząca danych jest przestawna nad oknem kodu innego niż źródłowy, ikona wypychania jest niedostępna, a porada dotycząca danych nie może zostać powtórzona. Aby uzyskać dostęp do ikony pushpin, zwróć poradę dotyczącą danych do okna edytora kodu, przeciągając go lub nadając fokus okna kodu.

Zamykanie porad dotyczących danych

Aby zamknąć poradę dotyczącą danych, umieść kursor nad poradą dotyczącą danych i wybierz ikonę zamknięcia (x) z menu kontekstowego.

Zamknij wszystkie porady dotyczące danych

Aby zamknąć wszystkie porady dotyczące danych, w menu Debugowanie wybierz pozycję Wyczyść wszystkie porady dotyczące danych.

Zamknij wszystkie porady dotyczące danych dla określonego pliku

Aby zamknąć wszystkie porady dotyczące danych dla określonego pliku, w menu Debugowanie wybierz pozycję Wyczyść wszystkie porady dotyczące danych Przypięte do <nazwy pliku>.

Rozwijanie i edytowanie informacji

Możesz użyć porad dotyczących danych, aby rozwinąć tablicę, strukturę lub obiekt, aby wyświetlić jego składowe. Możesz również edytować wartość zmiennej na podstawie porad dotyczących danych.

Rozwijanie zmiennej

Aby rozwinąć obiekt w poradzie danych, aby wyświetlić jego elementy, umieść kursor na strzałkach rozwijania przed nazwami elementów, aby wyświetlić elementy w formularzu drzewa. W przypadku przypiętej porady dotyczącej danych wybierz + wartość przed nazwą zmiennej, a następnie rozwiń drzewo.

Expand a data tip

Możesz użyć myszy lub klawiszy strzałek na klawiaturze, aby przejść w górę i w dół w widoku rozwiniętym.

Możesz również przypiąć rozwinięte elementy do przypiętej końcówki danych, umieszczając kursor na nich i wybierając ikony wypychania. Elementy są następnie wyświetlane w przypiętej wskazówce danych po zwinięciu drzewa.

Edytowanie wartości zmiennej

Aby edytować wartość zmiennej lub elementu w poradzie danych, wybierz wartość, wpisz nową wartość i naciśnij klawisz Enter. Zaznaczenie jest wyłączone dla wartości tylko do odczytu.

Przypinanie właściwości w poradach dotyczących danych

Uwaga

Ta funkcja jest obsługiwana dla platformy .NET Core 3.0 lub nowszej.

Możesz szybko sprawdzić obiekty według ich właściwości w poradach dotyczących danych za pomocą narzędzia Przypięte właściwości . Aby użyć tego narzędzia, umieść kursor nad właściwością i wybierz ikonę pinezki, która zostanie wyświetlona lub kliknij prawym przyciskiem myszy, a następnie wybierz opcję Przypnij element członkowski jako ulubiony w wyświetlonym menu kontekstowym. To bąbelki w górę tej właściwości na początku listy właściwości obiektu, a nazwa właściwości i wartość są wyświetlane w prawej kolumnie porady danych. Aby odpiąć właściwość, wybierz ponownie ikonę pinezki lub wybierz opcję Odepnij element członkowski jako ulubiony w menu kontekstowym.

Pinning a property in a data tip

Można również przełączać nazwy właściwości i filtrować nieprzypinane właściwości podczas wyświetlania listy właściwości obiektu w poradzie danych. Aby uzyskać dostęp do jednej z opcji, kliknij prawym przyciskiem myszy wiersz zawierający właściwość i wybierz opcję Pokaż tylko przypięte elementy członkowskie lub Ukryj przypięte nazwy elementów członkowskich w opcjach wartości w menu kontekstowym.

Wizualizowanie złożonych typów danych

Ikona lupy obok zmiennej lub elementu w poradzie danych oznacza, że co najmniej jeden wizualizator, taki jak Wizualizator tekstu, jest dostępny dla zmiennej. Wizualizatory wyświetlają informacje w bardziej zrozumiały, czasami graficzny sposób.

Aby wyświetlić element przy użyciu domyślnego wizualizatora dla typu danych, wybierz ikonę lupy Visualizer icon. Wybierz strzałkę obok ikony lupy, aby wybrać z listy wizualizatorów dla typu danych.

Dodawanie zmiennej do okna czujki

Jeśli chcesz nadal obserwować zmienną, możesz dodać ją do okna Obserwowanie z porady o danych. Kliknij prawym przyciskiem myszy zmienną w poradzie danych, a następnie wybierz pozycję Dodaj zegarek.

Zmienna jest wyświetlana w oknie Obserwowanie . Jeśli wersja programu Visual Studio obsługuje więcej niż jedno okno zegarka , zmienna jest wyświetlana w zegarku Watch 1.

Porady dotyczące importowania i eksportowania danych

Możesz wyeksportować porady dotyczące danych do pliku XML, który można udostępnić lub edytować za pomocą edytora tekstów. Możesz również zaimportować otrzymany lub edytowany plik XML porad dotyczących danych.

Aby wyeksportować porady dotyczące danych:

  1. Wybierz pozycję Debuguj>dane eksportu Wskazówki.

  2. W oknie dialogowym Eksportowanie danych Wskazówki przejdź do lokalizacji, aby zapisać plik XML, wpisz nazwę pliku, a następnie wybierz pozycję Zapisz.

Aby zaimportować porady dotyczące danych:

  1. Wybierz pozycję Debuguj>dane importu Wskazówki.

  2. W oknie dialogowym Importowanie porad dotyczących danych wybierz plik XML porad dotyczących danych, który chcesz otworzyć, a następnie wybierz pozycję Otwórz.