Home.NET Utilize the Full Functionality of the Whid...
Utilize the Full Functionality of the Whidbey File Management
This article is based on a pre-release version of Microsoft Visual Studio 2005, formerly code-named “Whidbey.” All information contained herein is subject to change. Topics covered include File System Management and its uses, file permissions, and file modes, file access and file shares.
Note: This article uses the following technologies: VB.NET and Windows Forms, File Management in Whidbey/VB.NET -- the beating heart of the technologies that comprise Windows Forms.
This article explains various file management operations such as read or write, retrieving properties or setting the properties or copy or move a file using the Whidbey/Visual Studio.NET environment. I hope this will be helpful in understanding the operation of managing a file.
System.IO.namespace
The input/output operation of file management is handled by the classes in the System.IO.namespace. The System.IO.namespace supports the following activities:
Reading and writing to binary files, text files etc.
Reading and writing to data streams
Basic file support
Directory support
Memory streams
Network streams
You have to include this namespace to your project.
The following classes will support System.IO.namespace in VB.NET.
1. The class Binary Reader used for Reads primitive data types as binary values. Primitive data types are those that are not defined in terms of other data types. Because primitive data types are the basis for all other types, they cannot have element content or attributes. Examples of primitive data types are string, float, decimal, anyURI, and QName.
Usage:
Dim objBinReader as New BinaryReader(File.Open _ (“C:\mysamplefile.txt”, FileMode.Open))
2. The class BinaryWriter used for writes primitive data types as binary values to a stream.
Usage:
Dim objBinWriter as New BinaryWriter(File.Open _ (“C:\mysamplefile.txt”, FileMode.Create))
3. The class BufferedStream used for buffering to another stream for read and write operations.
Usage:
‘ Create an NetworkStream object “objNetStream” that owns clientSocket
Dim objNetStream as New NetworkStream(ClientSocket, True) ‘ Create an BufferedStream object ‘ “objBufStream” on top of the NetworkStream
Dim objBufStream as New _ BufferedStream(objNetStream, _ intStreamBufferSize)
Note: The NetworkStream class provides methods for sending and receiving data over Stream sockets in blocking mode.
4. The class Directory used for creating, copying, moving, deleting and renaming directories and sub directories. The Directory class includes the System.IO namespace.
Some of the public methods used for Directory class are described as follows.
CreateDirectory – Creates a new directory in a specified path.
Delete - Delete the directory from the specified path
Exists – Checks whether the associated directories exists in the specific path
GetCreationTime – Get the creation time of directory
GetCreationTimeUtc – Get the creation time in universal coordinated time
GetCurrentDirectory – Get the current working directory of the application
GetDirectories – Gets the name of subdirectories in the working folder
GetDirectoryRoot – Get root and volume information for the specified path
GetFiles - Get or returns all the files listed in the specified directory
GetFileSytemEntries - Get or returns all the files and sub directories listed in the specified directory
GetLastAccessTime – Last access date and time of the specified directory
GetLastAccessTimeUtc – Last access date and time of the specified directory in universal coordinator time (UTC) format
GetLastWriteTime – Last written date and time of a specified directory
GetLastWriteTimeUtc – Last written date and time of a specified directory in universal coordinator time (UTC)
GetLogicalDrives – Get all the logical drives on the computer
GetParent – Get the absolute and relative path of the parent directory
Move – Move the specific directory to another location
SetCreationTime – Sets the creation date and time for the specified directory or file
SetCreationTimeUtc – Sets the creation date and time for the specified directory or file in universal coordinated time format
SetCurrentDirectory – Sets the current directory to a specified directory in an application path
SetLastAccessTime - Sets the last access date and time for the specified directory or file
Usage:
‘ Checking whether the directory exists in the specified path
Dim strMyPath as String = “C:\mySample”
If Directory.Exists(strMyPath) = True then Directory.Delete(strMyPath) Else Directory.CreateDirectory (strMyPath) End if
5. The class DirectoryInfo used the same functionality as Directory class except if you are not going to reuse an object several times.
6. The class DirectoryNotFoundException throws exception error when the file or directory not found in the specified path.
7. The class EndOfStreamException throws exception error at the past the end of a stream.
8. The class ErrorEventArgs provides data for Error event.
Usage:
‘ Checking whether the directory exists in the specified path
Dim strMyPath as String = “C:\mySample”
‘ Initializes the “objException” Exception object
Dim objException as New Exception(“Cannot create Directory”)
‘ Creates an ErrorEventArgs with the exception. Dim objErrorEventArgs as New ErrorEventArgs(objException)
If Directory.Exists(strMyPath) = True then Directory.Delete(strMyPath) Else Directory.CreateDirectory (strMyPath) End if
‘ Retrieves Exception from ErrorEventArgs
Dim objReturnedException as Exception= objErrorEventArgs.GetException()
If objReturnedException.Message <> “” then MessageBox.Show(objReturnedException.Message End if
End Sub
9. The class File provides to manage the file manipulation operations such as Creating, Opening, Deleting, Copying and Moving of files using FileStream objects. File class methods are static.
Some of the Public Methods used with File class is as follows:
AppendText
Copy
Create
CreateText
Delete
Exists
GetAttributes
GetCreationTime
GetCreationTimeUtc
GetLastAccessTime
GetLastAccessTimeUtc
GetLastWriteTime
Move
Open
OpenRead
OpenText
OpenWrite
SetAttributes
SetCreationTime
SetCreationTimeUtc
SetLastAccessTime
SetLastAccessTimeUtc
SetLastWriteTime
SetLastWriteTimeUtc
Usage:
‘ Initializing File class aids in the creation of FileStream objects
Try Dim strMyPath As String=”C:\Benoy\temp.txt” Dim strMyCopyPath As String = _ “C:\Benoy\temp1.txt” Dim objFS As FileStream = _ File.Create(strMyPath)
‘ Closing the file objFS.Close
‘ Copy the file File.Copy(strMyPath,strMyCopyPath ‘ Delete the file File.Delete(strMyPath)
Catch MessageBox.Show(“Error in File Operation”) End Try
10. The class FileInfo provides the same file management operation as in File class such as Creating, Opening, Deleting, Copying and Moving of files using FileStream objects, except if you are not reusing the object several times because the security check is not always necessary.
11. The class FileLoadException throws exception error if any error occurs during File Load.
Some of the public methods used with this class are shown below:
FileName – The associated filename that causes exception.
FusionLog – Get the log file.
HelpLink - Help Link association during exception error.
InnerException – An inner exception that caused the current exception.
Message - Exception Error Message.
Source – Error Source.
StackTrace – The associated string representation of the frames on the call stack.
TargetSite – The associated method name that causes exception.
12. The FileNotFoundException class throws the exception error when the associated file is not found in the specified path or invalid disk access. The public methods are same as FileLoadException class.
13. The FileStream class supports to read, write, open and close the file management operations as well as it supports to manage the operating system file operations such as pipes, standard input and output.
14. The FileSystemEventArgs class provides data for the directory events as shown below.
Changed event handler fires the properties or security details such as size, system attributes, last write time, last access time, whenever a file is changed or updated.
Created event handler fires whenever a directory or file created in a specified path.
Deleted event handler fires whenever a file or directory is deleted from the specified path.
15. The FileSystemInfo class supports the public methods which you can use for both files and directory in the specified path, which serving as the basis for two objects such as FileInfo and DirectoryInfo, which we understand from above.
16. The FileSystemWatcher class allows to notify or fires any changes occurs in the file system or directory such as a file or directory changed, deleted or created.
Figure 1 shows the NotifyFilter properties, that you can use to watch the notifications.
Figure 1 NotifyFilter Properties
Usage:
‘ Create a new FileSystemWatcher and its properties
Try Dim objFileSystemWatcher as New _ FileSystemWatcher()
‘ Watch the notification for LastAccess and LastWrite, FileName, CrationTime and the renaming of files and directories objFileSystemWatcher.NotifyFilter= (NotifyFilters.LastWrite Or NotifyFilters.LastAccess Or NotifyFilters.FileName Or NotifyFilters.DirectoryName Or NotifyFilters.FileName Or NotifyFilters.CreationTime)
‘ Only watch doc files objFileSystemWatcher.Filter = “*.doc”
‘ Begin watching event for changed, deleted, renamed and created objFileSystemWatcher.EnableRaisingEvents=True
' Define the event handlers. Private Shared Sub OnChanged(ByVal source As Object, ByVal e As FileSystemEventArgs) ' Specify what is done when a file is changed, created, or deleted. MessageBox.Show("File: " & e.FullPath & " " & e.ChangeType) End Sub
Private Shared Sub OnCreated(ByVal source As Object, ByVal e As RenamedEventArgs) ' Specify what is done when a file is renamed. MessageBox.Show("File: {0} renamed to {1}", e.OldFullPath, e.FullPath)
Catch MessageBox.Show(“Error in File Operation”) End Try
17. The InternalBufferOverFlowException class throws exception when the buffer overflows during execution of the programs. It supports some of the public methods as shown in the FileLoadException class except FusionLog and FileName, which you saw above.
18. The IOException class throws exception when Input/Output error occurs. It supports some of the public methods as shown in the FileLoadException class except FusionLog and FileName, which you saw above.
19. The MemoryStream class creates streams that have memory as an array instead of a disk or any storage media. It can reduce the need for temporary buffers and files in an application.
Usage:
Try
‘ Create a new instance of MemoryStream object Dim objMemoryStream as New MemoryStream(200)
‘ Create an instance of UnicodeEncoding Dim objUnicodeEncoding As New UnicodeEncoding()
‘ Create array of string variables. Dim strMyText As Byte() = _
objUnicodeEncoding.GetBytes("File Management using Whidbey/VB.NET")
The enumeration to get or set file permissions in VB.net is called FileIOPermissionAccess enumerations, which used with the FileIOPermission class. The system namespace used for this enumeration is System.Security.Permissions namespace, which implements IUnrestrictedPermission interface, which defines classes that control access to operations and resources based on permission policy.
Classes that supports System.Security.Permissions
The following classes will support System.Security.Permissions in VB.NET.
FileMode parameter control has the following members:
Append – Append to an existing file or create a new file if the file not exists
Create - Create a new file
Open – Open the file
OpenCreate - Open a file if exists or it will create a file
Truncate – Remove all the contents so that its size is zero bytes
Example:
Dim objStreamReader As New StreamReader(“C:\benoy\Mytext.txt”) MessageBox.Show(objStreamReader.ReadToEnd() objStreamReader.Close()
FileShare
FileShare enumeration allows you to control the share permission to access the FileStreams.
Some of the members included in the FileShare enumerations are Read, ReadWrite, Write, None, Inheritable etc.
Read command allows you to opening the file for reading. ReadWrite command allows you to opening the file for reading and writing.
Write command allows you to opening the file for writing.
Dim objFileStream As New FileStream(“C:\benoy\Mytext.txt”, _ FileMode. OpenOrCreateOpen, FileAccess.ReadWrite, FileShare.ReadWrite)
FileAccess
FileAccess enumeration allows you to control the permission to access the FileStreams.
Some of the members included in the FileAccess enumerations are Read, ReadWrite, Write etc.
Conclusion
In this article we found out how to manage windows file operations using different file level operation commands. It allows you to set file permissions, modes, access and sharing of files using VB.NET environment.
• File System Management and its uses • File Permissions • File modes, File Access, File Shares
Secure Audio Streaming with ASP.Net and Flash
