Skip to content

Document TagWithCallSite method in Query Tags documentation #5215

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
Copilot wants to merge 6 commits into
base: main
Choose a base branch
from
Open

Document TagWithCallSite method in Query Tags documentation #5215

Changes from all commits
Commits
Show all changes
6 commits
Select commit Hold shift + click to select a range
536035e
Initial plan
Copilot Dec 31, 2025
fb46d06
Document TagWithCallSite method in Query Tags documentation
Copilot Dec 31, 2025
7fc6794
Update line numbers in TagWithCallSite examples
Copilot Dec 31, 2025
81bc870
Add note about line numbers in TagWithCallSite documentation
Copilot Dec 31, 2025
39b34b3
Address review feedback: inline code sample, remove version reference…
Copilot Dec 31, 2025
a76404a
Use xref for TagWithCallSite API reference
Copilot Dec 31, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
21 changes: 21 additions & 0 deletions entity-framework/core/querying/tags.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -68,6 +68,27 @@ FROM [People] AS [p]
ORDER BY [p].[Location].STDistance(@__myLocation_0) DESC
```

## Tagging with file name and line number

Queries can be automatically tagged with the file name and line number where the LINQ query is defined in source code. This is done using the <xref:Microsoft.EntityFrameworkCore.EntityFrameworkQueryableExtensions.TagWithCallSite*> method:

```csharp
var myLocation = new Point(1, 2);
var closestPeople = await (from f in context.People.TagWithCallSite()
orderby f.Location.Distance(myLocation) descending
select f).Take(5).ToListAsync();
```

This query translates to (the actual line number will reflect where the query is defined in the source file):

```sql
-- file: C:\Work\EntityFramework.Docs\samples\Program.cs:23

SELECT TOP(@__p_1) [p].[Id], [p].[Location]
FROM [People] AS [p]
ORDER BY [p].[Location].STDistance(@__myLocation_0) DESC
```

## Known limitations

**Query tags aren't parameterizable:**
Expand Down