Добавил:
Опубликованный материал нарушает ваши авторские права? Сообщите нам.
Вуз: Предмет: Файл:
Build Your Own ASP.NET 2.0 Web Site Using CSharp And VB (2006) [eng]-1.pdf
Скачиваний:
142
Добавлен:
16.08.2013
Размер:
15.69 Mб
Скачать

Chapter 14: Working with Files and Email

Writing Content to a Text File

For the purposes of the next few exercises, let’s work again with our old friend, the Learning web application. Start Visual Web Developer, go to File > Open Web Site, and open the Learning application.

Right-click the project in Solution Explorer, and select Add New Item. Select the

Web Form template, name it WriteFile.aspx, and make sure you aren’t using a code-behind file or a master page. Click Add, then enter the code shown here in bold:

File: WriteFile.aspx (excerpt)

<%@ Page Language="VB" %>

<%@ Import Namespace="System.IO" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server"> </script>

<html xmlns="http://www.w3.org/1999/xhtml"> <head runat="server">

<title>Writing to Text Files</title> </head>

<body>

<form id="form1" runat="server">

Write the following text within a text file:<br /> <asp:TextBox ID="myText" runat="server" />

<asp:Button ID="writeButton" Text="Write" runat="server" OnClick="WriteText" />

</form>

</body>

</html>

As you can see, we import the System.IO namespace—the namespace that contains the classes for working with text files—first. Next, we add a TextBox control to handle collection of the user-entered text, and a Button control to send the information to the server for processing.

Next, in the <head> tag, we’ll create the WriteText method mentioned in the OnClick attribute of the Button. This method will write the contents of the TextBox to the text file:

576

Writing Content to a Text File

Visual Basic

File: WriteFile.aspx (excerpt)

<script runat="server">

Sub WriteText(ByVal s As Object, ByVal e As EventArgs) Using streamWriter As StreamWriter = File.CreateText( _

"C:\WebDocs\Learning\myText.txt")

streamWriter.WriteLine(myText.Text) End Using

End Sub </script>

C#

File: WriteFile.aspx (excerpt)

<script runat="server">

void WriteText(Object s, EventArgs e)

{

using (StreamWriter streamWriter = File.CreateText( @"C:\WebDocs\Learning\myText.txt"))

{

streamWriter.WriteLine(myText.Text);

}

}

</script>

Apart from the new Using construct, the code is pretty straightforward. First, we create a StreamWriter variable called streamWriter. To obtain the variable’s value, we call the CreateText method of the File class, passing in the location of the text file, which returns a new StreamWriter. Don’t forget that C# needs to escape backslashes when they’re used in strings, so the path to our file must use \\ to separate folder names, or use the @ character in front of the string so that backslashes are automatically ignored.

What about Using, then? Similarly to database connections, streams are something that we need to close when we’re done working with them, so they don’t occupy resources unnecessarily. The Using construct is a common means of ensuring that the stream is closed and disposed of after we work with it.

Disposing of Objects

Technically, when we work with Using, the object is disposed of, rather than simply closed. The action is identical to explicitly calling its Dispose method.

When the code enclosed by Using finishes executing, streamWriter’s Dispose method is called automatically for you. This ensures that it doesn't keep any resources locked, and that the object itself is removed from memory immediately.

577

Chapter 14: Working with Files and Email

In the world of .NET, closed objects are cleared from memory at regular intervals by .NET’s Garbage Collector, but for classes that support the Dispose method (such as StreamWriter), you can use this method (or the Using construct) to remove an object from memory immediately.

It’s also interesting to note the way we used the File class’s CreateText method in the code above. Normally, when we need to call a method of a particular class, we create an object of that class first. How was it possible to call the CreateText method using a class name, without creating an object of the File class first?

The CreateText method is what Visual Basic calls a shared method, and what’s known in C# as a static method. Shared or static methods can be called without our having to create an actual instance of the class. In the above code, CreateText is a shared or static method, because we can call it directly from the File class, without having to create an instance of that class.

We worked with shared/static class members earlier, when we read the connection string. In that case, you didn’t need to create an object of the ConfigurationManager class in order to read your connection string:

Visual Basic

string connectionString = ConfigurationManager.ConnectionStrings( _ "Dorknozzle").ConnectionString

Instance methods, on the other hand, are those with which you’re familiar—they may only be called on an instance (object) of the class. Instance methods are most commonly used, but shared/static methods can be useful for providing generic functionality that doesn’t need to be tied to a particular class instance.

Now, test the page in your browser. Initially, all you’ll see is an interface similar to Figure 14.4.

Type some text into the text box, and click the Write button to submit your text for processing. Browse to and open the myText.txt file in Notepad, and as in Figure 14.5, you’ll see the newly added text.

If you try to enter a different value into the TextBox control and click the Write button, the existing text will be overwritten with the new content. To prevent this from happening, you can replace the call to the CreateText method with a call to AppendText. As Figure 14.6 shows, the AppendText method adds to existing text, rather than replacing it.

578

Writing Content to a Text File

Figure 14.4. Writing text to a file

Figure 14.5. Viewing your new file in Notepad

Figure 14.6. Appending text

Also note that, rather than specifying the full path to the text file, you can use the MapPath method to generate the full path to the text file automatically. All you need to do is give the method a path relative to the current directory, as follows:

Visual Basic

File: WriteFile.aspx (excerpt)

Using streamWriter As StreamWriter = File.AppendText( _ MapPath("myText.txt"))

579