Session: Querying: How to use highlighting?

Highlighting can be a great feature for increasing search UX. To take leverage of it use Highlight method which is a part of query customizations available from Customize.

Syntax

IDocumentQueryCustomization Highlight(
	string fieldName,
	int fragmentLength,
	int fragmentCount,
	string fragmentsField);

IDocumentQueryCustomization Highlight(
	string fieldName,
	int fragmentLength,
	int fragmentCount,
	out FieldHighlightings highlightings);

Example

FieldHighlightings highlightings = null;
SearchItem[] results = session
	.Query<SearchItem>("ContentSearchIndex")
	.Customize(x => x.Highlight("Text", 128, 1, out highlightings))
	.Search(x => x.Text, "raven")
	.ToArray();

StringBuilder builder = new StringBuilder()
	.AppendLine("<ul>");

foreach (SearchItem result in results)
{
	string[] fragments = highlightings.GetFragments(result.Id);
	builder.AppendLine(string.Format("<li>{0}</li>", fragments.First()));
}

string ul = builder
	.AppendLine("</ul>")
	.ToString();