Share via

  • Artykuł

/ *... * / (Komentarz) (Transact-SQL)

Wskazuje tekst dostarczonych przez użytkownika.Tekst między / * i * / nie jest sprawdzane przez serwer.

Ikona łącza do tematuJęzyka Transact-SQL składni konwencje

Składnia

/*
text_of_comment
*/

Argumenty

  • text_of_comment
    Jest to tekst komentarza.Jest to jeden lub więcej ciągów znaków.

Uwagi

Komentarze można wstawiać w oddzielnym wierszu lub w Transact-SQL instrukcja.Komentarze wielowierszowe muszą być wskazywane przez / * i * /.Stylistyczne Konwencji często używane dla wielu linii komentarzy jest rozpoczęcie pierwszy wiersz z / *, kolejnych wierszy z *i kończy się na * /.

Nie ma żadnych maksymalna długość komentarzy.

Obsługiwane są zagnieżdżone komentarza.Jeśli / * znaków wystąpi w dowolnym w ramach istniejącego komentarza, jest traktowana jako początek zagnieżdżone komentarza i, dlatego wymaga zamknięcia * / znacznik komentarza.Jeśli znacznik komentarza zamknięcia nie istnieje, zostanie wygenerowany błąd.

Na przykład poniższy kod generuje błąd.

DECLARE @comment AS varchar(20);
GO
/*
SELECT @comment = '/*';
*/ 
SELECT @@VERSION;
GO

W celu obejścia tego błędu, należy wprowadzić następujące zmiany.

DECLARE @comment AS varchar(20);
GO
/*
SELECT @comment = '/*';
*/ */
SELECT @@VERSION;
GO

Przykłady

W poniższym przykładzie użyto komentarze do wyjaśnienia sekcji kodu powinien zrobić.

USE AdventureWorks2008R2;
GO
/*
This section of the code joins the Person table with the Address table, 
by using the Employee and BusinessEntityAddress tables in the middle to 
get a list of all the employees in the AdventureWorks2008R2 database 
and their contact information.
*/
SELECT p.FirstName, p.LastName, a.AddressLine1, a.AddressLine2, a.City, a.PostalCode
FROM Person.Person AS p
JOIN HumanResources.Employee AS e ON p.BusinessEntityID = e.BusinessEntityID 
JOIN Person.BusinessEntityAddress AS ea ON e.BusinessEntityID = ea.BusinessEntityID
JOIN Person.Address AS a ON ea.AddressID = a.AddressID;
GO