ASP.NET Web Pages Using The Razor Syntax 
Appendix – ASP.NET Quick API Reference 
217 
If the current user is not the user specified by username, sets the HTTP status to 401 (Unauthorized). 
WebSecurity.RequireUser("joe@contoso.com"); 
WebSecurity.ResetPassword(
passwordResetToken
,
newPassword
)
If the password reset token is valid, changes the user’s password to the new password. 
WebSecurity.ResetPassword( "A0F36BFD9313", "new-password") 
Data 
Database.Execute(
SQLstatement [
parameters]
Executes SQLstatement (with optional parameters) such as INSERT, DELETE, or UPDATE and returns a 
count of affected records. 
db.Execute("INSERT INTO Data (Name) VALUES ('Smith')");  
db.Execute("INSERT INTO Data (Name) VALUES (@0)", "Smith"); 
Database.GetLastInsertId()
Returns the identity column from the most recently inserted row. 
db.Execute("INSERT INTO Data (Name) VALUES ('Smith')");  
var id = db.GetLastInsertId(); 
Database.Open(
filename
Database.Open(
connectionStringName
)
Opens either the specified database file or the database specified using a named connection string 
from the Web.config file. 
// Note that no filename extension is specified. 
var db = Database.Open("SmallBakery"); // Opens SmallBakery.sdf in App_Data 
// Opens a database by using a named connection string. 
var db = Database.Open("SmallBakeryConnectionString"); 
Database.OpenConnectionString(
connectionString
)
Opens a database using the connection string. (This contrasts with 
Database.Open
, which uses a 
connection string name.) 
var db = Database.OpenConnectionString("Data Source=|DataDirectory|\SmallBakery.sdf"); 
Database.Query(
SQLstatement[, parameters]
)
Queries the database using SQLstatement (optionally passing parameters) and returns the results as a 
Creating bookmarks in a pdf document - add, remove, update PDF bookmarks in C#.net, ASP.NET, MVC, Ajax, WinForms, WPF
Empower Your C# Project with Rapid PDF Internal Navigation Via Bookmark and Outline
how to bookmark a pdf in reader; create bookmark pdf
Creating bookmarks in a pdf document - VB.NET PDF bookmark library: add, remove, update PDF bookmarks in vb.net, ASP.NET, MVC, Ajax, WinForms, WPF
Empower Your VB.NET Project with Rapid PDF Internal Navigation Via Bookmark and Outline
how to create bookmark in pdf automatically; copy pdf bookmarks to another pdf
ASP.NET Web Pages Using The Razor Syntax 
Appendix – ASP.NET Quick API Reference 
218 
collection.  
foreach (var result in db.Query("SELECT * FROM PRODUCT")) {<p>@result.Name</p>}  
foreach (var result = db.Query("SELECT * FROM PRODUCT WHERE Price > @0", 20))  
{ <p>@result.Name</p> } 
Database.QuerySingle(
SQLstatement
[, parameters]
)
Executes SQLstatement (with optional parameters) and returns a single record. 
var product = db.QuerySingle("SELECT * FROM Product WHERE Id = 1");  
var product = db.QuerySingle("SELECT * FROM Product WHERE Id = @0", 1); 
Database.QueryValue(
SQLstatement
[, parameters]
)
Executes SQLstatement (with optional parameters) and returns a single value. 
var count = db.QueryValue("SELECT COUNT(*) FROM Product");  
var count = db.QueryValue("SELECT COUNT(*) FROM Product WHERE Price > @0", 20); 
Helpers 
Analytics.GetGoogleHtml(
webPropertyId
)
Renders the Google Analytics JavaScript code for the specified ID. 
@Analytics.GetGoogleHtml("MyWebPropertyId") 
Analytics.GetStatCounterHtml(
project
security
)
Renders the StatCounter Analytics JavaScript code for the specified project. 
@Analytics.GetStatCounterHtml(89, "security") 
Analytics.GetYahooHtml(
account
)
Renders the Yahoo Analytics JavaScript code for the specified account. 
@Analytics.GetYahooHtml("myaccount") 
Bing.SearchBox(
[boxWidth]
)
Passes a search to Bing. To specify the site to search and a title for the search box, you can set the 
Bing.SiteUrl
and 
Bing.SiteTitle
properties. Normally you set these properties in the _AppStart page.  
@Bing.SearchBox() @* Searches the web.*@ 
@{ 
Bing.SiteUrl = "www.asp.net";  @* Limits search to the www.asp.net site. *@ 
C# Create PDF Library SDK to convert PDF from other file formats
Gratis control for creating PDF from multiple image formats such as PDF with a blank page, bookmarks, links, signatures Create fillable PDF document with fields.
how to create bookmarks in pdf file; create pdf bookmark
How to C#: Basic SDK Concept of XDoc.PDF for .NET
features can be integrated into your C# project, such as annotation creating, deleting, modifying OutLines. This class describes bookmarks in a PDF document.
bookmarks pdf documents; bookmark a pdf file
ASP.NET Web Pages Using The Razor Syntax 
Appendix – ASP.NET Quick API Reference 
219 
@Bing.SearchBox() 
Bing.AdvancedSearchBox(
[, boxWidth] [, resultWidth] [, resultHeight]  
[, themeColor] [, locale]
)
Displays Bing search results in the page with optional formatting. To specify the site to search and a 
title for the search box, you can set the 
Bing.SiteUrl
and 
Bing.SiteTitle
properties. Normally you set 
these properties in the _AppStart page.  
@{ 
Bing.SiteUrl = "www.asp.net"; 
Bing.SiteTitle = "ASP.NET Custom Search"; 
@Bing.AdvancedSearchBox( 
boxWidth: "250px", 
resultWidth: 600,  
resultHeight: 900, 
themeColor: "Green", 
locale: "en-US") 
Chart(
width
height [, template] [, templatePath]
)
Initializes a chart. 
@{ 
var myChart = new Chart(width: 600, height: 400); 
Chart.AddLegend(
[title] [, name]
)
Adds a legend to a chart. 
@{ 
var myChart = new Chart(width: 600, height: 400) 
.AddLegend("Basic Chart") 
.AddSeries( 
name: "Employee", 
xValue: new[] {  "Peter", "Andrew", "Julie", "Mary", "Dave" }, 
yValues: new[] { "2", "6", "4", "5", "3" }) 
.Write(); 
Chart.AddSeries(
[name] [, chartType] [, chartArea]  
[, axisLabel] [, legend] [, markerStep] [, xValue]  
[, xField] [, yValues] [, yFields] [, options])
Adds a series of values to the chart. 
@{ 
var myChart = new Chart(width: 600, height: 400) 
.AddSeries( 
name: "Employee", 
xValue: new[] {  "Peter", "Andrew", "Julie", "Mary", "Dave" }, 
yValues: new[] { "2", "6", "4", "5", "3" }) 
VB.NET PDF: Basic SDK Concept of XDoc.PDF
features can be integrated into your VB.NET project, such as annotation creating, deleting, modifying This class describes bookmarks in a PDF document.
edit pdf bookmarks; display bookmarks in pdf
VB.NET Create PDF Library SDK to convert PDF from other file
Gratis control for creating PDF from multiple image formats with a blank page, bookmarks, links, signatures Create fillable PDF document with fields in Visual
how to add bookmarks to pdf files; creating bookmarks in a pdf document
ASP.NET Web Pages Using The Razor Syntax 
Appendix – ASP.NET Quick API Reference 
220 
.Write(); 
Crypto.Hash(
string [, algorithm]
Crypto.Hash(
bytes [, algorithm]
)
Returns a hash for the specified data. The default algorithm is 
sha256
@Crypto.Hash("data") 
Facebook.LikeButton(
href [, buttonLayout] [, showFaces] [, width] [, height]  
[, action] [, font] [, colorScheme] [, refLabel]
)
Lets Facebook users make a connection to pages. 
@Facebook.LikeButton("www.asp.net") 
FileUpload.GetHtml(
[initialNumberOfFiles] [
allowMoreFilesToBeAdded]  
[
includeFormTag] [, addText] [
uploadText]
)
Renders UI for uploading files. 
@FileUpload.GetHtml(initialNumberOfFiles:1, allowMoreFilesToBeAdded:false,  
includeFormTag:true, uploadText:"Upload") 
GamerCard.GetHtml(
gamerTag
)
Renders the specified Xbox gamer tag. 
@GamerCard.GetHtml("joe") 
Gravatar.GetHtml(
email [, imageSize] [, defaultImage] [, rating]  
[, imageExtension] [, attributes]
)
Renders the Gravatar image for the specified email address. 
@Gravatar.GetHtml("joe@contoso.com") 
Json.Encode(
object
)
Converts a data object to a string in the JavaScript Object Notation (JSON) format.  
var myJsonString = Json.Encode(dataObject); 
Json.Decode(
string
)
Converts a JSON-encoded input string to a data object that you can iterate over or insert into a 
database. 
var myJsonObj = Json.Decode(jsonString); 
LinkShare.GetHtml(
pageTitle [, pageLinkBack] [, twitterUserName]  
XDoc.Word for .NET, Advanced .NET Word Processing Features
Viewing, editing, converting, processing, creating, annotating and zooming & rotation; Outlines, bookmarks, & thumbnail Create Word from PDF; Create Word from
pdf bookmarks; bookmark template pdf
How to C#: Basic SDK Concept of XDoc.Word
Conversely, conversion from PDF to Word (.docx) is C# project, such as annotation creating, deleting, modifying This class describes bookmarks in a Word document
export pdf bookmarks to text; create bookmark in pdf automatically
ASP.NET Web Pages Using The Razor Syntax 
Appendix – ASP.NET Quick API Reference 
221 
[, additionalTweetText] [, linkSites]
)
Renders social networking links using the specified title and optional URL. 
@LinkShare.GetHtml("ASP.NET Web Pages Samples")  
@LinkShare.GetHtml("ASP.NET Web Pages Samples", "http://www.asp.net") 
ModelStateDictionary.AddError(
key
errorMessage
)
Associates an error message with a form field. Use the 
ModelState
helper to access this member.  
ModelState.AddError("email", "Enter an email address"); 
ModelStateDictionary.AddFormError(
errorMessage
)
Associates an error message with a form. Use the 
ModelState
helper to access this member.  
ModelState.AddFormError("Password and confirmation password do not match."); 
ModelStateDictionary.IsValid
Returns true if there are no validation errors. Use the 
ModelState
helper to access this member.  
if (ModelState.IsValid) { // Save the form to the database } 
ObjectInfo.Print(
value [, depth] [, enumerationLength]
)
Renders the properties and values of an object and any child objects.  
@ObjectInfo.Print(person) 
Recaptcha.GetHtml(
[, publicKey] [, theme] [, language] [, tabIndex]
)
Renders the reCAPTCHA verification test. 
@ReCaptcha.GetHtml() 
ReCaptcha.PublicKey 
ReCaptcha.PrivateKey
Sets public and private keys for the reCAPTCHA service. Normally you set these properties in the 
_AppStart page. 
ReCaptcha.PublicKey = "your-public-recaptcha-key";  
ReCaptcha.PrivateKey = "your-private-recaptcha-key"; 
ReCaptcha.Validate(
[, privateKey]
)
Returns the result of the reCAPTCHA test. 
if (ReCaptcha.Validate()) {  
// Test passed.  
How to C#: Basic SDK Concept of XDoc.PowerPoint
Conversely, conversion from PDF to PowerPoint (.PPTX C# project, such as annotation creating, deleting, modifying This class describes bookmarks in a PowerPoint
copy pdf bookmarks; pdf export bookmarks
PDF Image Viewer| What is PDF
such as text extraction, hyperlinks, bookmarks and metadata as to develop specifications for creating, viewing, and convert word document without need for PDF.
pdf bookmark editor; add bookmark to pdf reader
ASP.NET Web Pages Using The Razor Syntax 
Appendix – ASP.NET Quick API Reference 
222 
ServerInfo.GetHtml()
Renders status information about ASP.NET Web Pages. 
@ServerInfo.GetHtml() 
Twitter.Profile(
twitterUserName
)
Renders a Twitter stream for the specified user. 
@Twitter.Profile("billgates") 
Twitter.Search(
searchQuery
)
Renders a Twitter stream for the specified search text. 
@Twitter.Search("asp.net") 
Video.Flash(
filename [, width, height]
)
Renders a Flash video player for the specified file with optional width and height. 
@Video.Flash("test.swf", "100", "100") 
Video.MediaPlayer(
filename [, width, height]
)
Renders a Windows Media player for the specified file with optional width and height. 
@Video.MediaPlayer("test.wmv", "100", "100") 
Video.Silverlight(
filename
width
height
)
Renders a Silverlight player for the specified .xap file with required width and height. 
@Video.Silverlight("test.xap", "100", "100") 
WebCache.Get(
key
)
Returns the object specified by key, or null if the object is not found. 
var username = WebCache.Get("username") 
WebCache.Remove(
key
)
Removes the object specified by key from the cache. 
WebCache.Remove("username") 
WebCache.Set(
key
value [, minutesToCache] [, slidingExpiration]
)
Puts value into the cache under the name specified by key. 
WebCache.Set("username", "joe@contoso.com ") 
How to C#: Basic SDK Concept of XDoc.Excel
Conversely, conversion from PDF to Excel (.XLSX) is also C# project, such as annotation creating, deleting, modifying This class describes bookmarks in a Excel
add bookmarks pdf; export pdf bookmarks
ASP.NET Web Pages Using The Razor Syntax 
Appendix – ASP.NET Quick API Reference 
223 
WebGrid(
data
)
Creates a new 
WebGrid
object using data from a query. 
var db = Database.Open("SmallBakery"); 
var grid = new WebGrid(db.Query("SELECT * FROM Product")); 
WebGrid.GetHtml()
Renders markup to display data in an HTML table. 
@grid.GetHtml()// The 'grid' variable is set when WebGrid is created. 
WebGrid.Pager()
Renders a pager for the 
WebGrid
object. 
@grid.Pager() // The 'grid' variable is set when WebGrid is created. 
WebImage(
path
)
Loads an image from the specified path. 
var image = new WebImage("test.png"); 
WebImage.AddImagesWatermark(
image
)
Adds the specified image as a watermark. 
WebImage photo = new WebImage("test.png"); 
WebImage watermarkImage = new WebImage("logo.png"); 
photo.AddImageWatermark(watermarkImage); 
WebImage.AddTextWatermark(
text
)
Adds the specified text to the image. 
image.AddTextWatermark("Copyright") 
WebImage.FlipHorizontal() 
WebImage.FlipVertical()
Flips the image horizontally or vertically. 
image.FlipHorizontal();  
image.FlipVertical(); 
WebImage.GetImageFromRequest()
Loads an image when an image is posted to a page during a file upload. 
var image = WebImage.GetImageFromRequest(); 
ASP.NET Web Pages Using The Razor Syntax 
Appendix – ASP.NET Quick API Reference 
224 
WebImage.Resize(
width
,
height
)
Resizes an the image. 
image.Resize(100, 100); 
WebImage.RotateLeft()
WebImage.RotateRight()
Rotates the image to the left or the right. 
image.RotateLeft();  
image.RotateRight(); 
WebImage.Save(
path [, imageFormat]
)
Saves the image to the specified path. 
image.Save("test.png"); 
WebMail.Password
Sets the password for the SMTP server. Normally you set this property in the _AppStart page.  
WebMail.Password = "password"; 
WebMail.Send(
to
,
subject
body [, from] [, cc] [, filesToAttach] [, isBodyHtml]  
[, additionalHeaders]
)
Sends an email message. 
WebMail.Send("touser@contoso.com", "subject", "body of message", "fromuser@contoso.com"); 
WebMail.SmtpServer
Sets the SMTP server name. Normally you set this property in the _AppStart page. 
WebMail.SmtpServer = "smtp.mailserver.com"; 
WebMail.UserName
Sets the user name for the SMTP server. Normally you should set this property in the _AppStart page. 
WebMail.UserName = "Joe"; 
ASP.NET Web Pages Using The Razor Syntax 
Appendix – ASP.NET Web Pages Visual Basic 
225 
Appendix 
ASP.NET Web Pages Visual Basic 
This appendix gives you an overview of programming with ASP.NET Web pages in Visual Basic, using the 
Razor syntax. 
In this book the ASP.NET code examples using the Razor syntax are based on C#. But the Razor syntax 
also supports Visual Basic. To program an ASP.NET web page in Visual Basic, you create a web page with 
a .vbhtml filename extension, and then add Visual Basic code. This appendix gives you an overview of 
working with the Visual Basic language and syntax to create ASP.NET Webpages. 
What you'll learn: 
The top 8 programming tips. 
Visual Basic language and syntax. 
The Top 8 Programming Tips 
This section lists a few tips that you absolutely need to know as you start writing ASP.NET server code 
using the Razor syntax. 
1. You add code to a page using the @ character 
The 
@
character starts inline expressions, single-statement blocks, and multi-statement blocks:  
<!-- Single statement blocks  --> 
@Code  Dim total = 7  End Code 
@Code  Dim myMessage = "Hello World" End Code 
<!-- Inline expressions --> 
<p>The value of your account is: @total </p> 
<p>The value of myMessage is: @myMessage</p>         
<!-- Multi-statement block -->     
@Code  
Dim greeting = "Welcome to our site!" 
Dim weekDay = DateTime.Now.DayOfWeek 
Dim greetingMessage = greeting & " Today is: " & weekDay.ToString() 
End Code  
<p>The greeting is: @greetingMessage</p> 
The result displayed in a browser: 
ASP.NET Web Pages Using The Razor Syntax 
Appendix – ASP.NET Web Pages Visual Basic 
226 
HTML Encoding 
When you display content in a page using the 
@
character, as in the preceding examples, ASP.NET HTML-
encodes the output. This replaces reserved HTML characters (such as 
<
and 
>
and 
&
) with codes that 
enable the characters to be displayed as characters in a web page instead of being interpreted as HTML 
tags or entities. Without HTML encoding, the output from your server code might not display correctly, 
and could expose a page to security risks. 
If your goal is to output HTML markup that renders tags as markup (for example 
<p></p>
for a paragraph 
or 
<em></em>
to emphasize text), see the section Combining Text, Markup, and Code in Code Blocks later 
in this chapter. 
You can read more about HTML encoding in Chapter 4 - Working with Forms
2. You enclose code blocks with Code...End Code 
A code block includes one or more code statements and is enclosed with the keywords 
Code
and 
End 
Code
. Place the opening 
Code
keyword immediately after the 
@
character — there can't be whitespace 
between them.  
<!-- Single statement block.  --> 
@Code 
Dim theMonth = DateTime.Now.Month 
End Code 
<p>The numeric value of the current month: @theMonth</p> 
<!-- Multi-statement block. --> 
@Code 
Dim outsideTemp = 79 
Dim weatherMessage = "Hello, it is " & outsideTemp & " degrees." 
End Code  
<p>Today's weather: @weatherMessage</p> 
The result displayed in a browser: 
Documents you may be interested
Documents you may be interested