What is mirroring?

Mirroring constantly synchronizes the transaction log of a mirror server with the transaction log of a principal server. The synchronization can be either synchronal to enable high availability, or asynchronal to enable high performance.

If set to high availability, a witness server is required. this can be either the principal server itself, or a 3rd server. If a 3rd server is chosen, this ensures more security in case of a failure.

To configure mirroring, the mirror server must restore a backup of the principal with NORECOVERY mode. Thus you cannot access the mirror database directly, since it remains in recovery mode. But you can create a snapshot of the mirror to read data. Also, the database must set to full recovery mode. (Note: if you want to have a full working copy of a database, then log shipping or replication is your choice over mirroring)

Mirroring requires endpoints (TCP or HTTP) for the principal, the witness and the mirror server. The endpoints are configured automatically, when you create mirroring in the properties options of the database.

The main purpose for mirroring however is to have a high available backup in case of an error of the principal server.  In High Availability mode, a failover is automatically performed to the mirror, when a failure occurs on the principal. Otherwise you need to launch a failover manually:

ALTER DATABASE <mirror_database> SET PARTNER FORCE_SERVICE_ALLOW_DATA_LOSS

When you right click any Database in the SSMS, you can access the Copy Database tool:

This feature easily allows you to copy or move a database from one server to another or within one server.

But before you can do this you need to ensure the following conditions:

• SQL Server Agent service must be running on the destination server
• SQL Server Integration Services service must be running on the destination server
• These services must be running with an account that has at least sysdbadmin rights on the target sql server.
• The source database must not have an owner that is a local account to the source server (e.g. LocalServer1\Tom),
  otherwise the transfer will fail. If it is associated with a local account, change the owner, for instance to sa.

After the prerequisites are confirmed, you can launch the Copy Database wizard. There are currently two ways to copy or move the database:

1. Use the detach and attach method
2. Use the SQL Management Object Method

Use the SQL Management Object Method

1) is significantly faster but requires a share on the target server and a configured Integration Services Proxy Account on the target server. So the easiest way to copy the source is method 2).

After some view steps in the wizard, you reach the Select Server Objects page where Logins are preselected:

Copying the Logins is not necassarily required unless you have granted some rights to specific logins, so in some cases you can remove the Logins from the Selected related objects list. in some cases.

Use the detach and attach method

If you decide to use this method to copy or move a database, before you can archive this, you need to create a Credential and a Proxy for the SSIS Package Execution in the SQL Server Agent:

To create a credential that will be later associated to the proxy open Server/Security/Credential and right click to open the popup menu where you select New Credential:

The New Credential Dialog is self explanatory so just configure the required values.

Now you can create a  Proxy:

In the dialog select a proxy name of your choice and as Credential name select the previously created credential. Select at least “SQL Server Integration Services Package” and that’s it:

Sometimes you need to get a result set for a field that contains any value from an array.
The default approach in LINQ would be:

from var c in data where array.Contains(c.field) select c;

which creates a T-SQL that looks like that:

select * from data where data.field in (1,2,3,...)

Unfortunately, this would produce an error with EF, since Contains is currently not implemented with .NET 3.5SP1.

Therefore, we need a workarround that builds an expression that implements an or for each indiviudal value in the array to be compared against the field:

private void button2_Click(object sender, RoutedEventArgs e)
{
    int[] types = new int[] { 1, 2, 3, 10 };
    using (TomsPortal.TomsPortalEntities1 tp = new TomsPortalEntities1())
    {
        var r = from node in tp.Node where node.Taxonomy.Id != 3 where Contains<Node, int>(types) select node;
        r = r.Where(Contains<Node, int>(node => node.Id, types));

        foreach (var o in r)
        {
            Trace.WriteLine(o.Id);
        }
    }
}

static Expression<Func<TElement, bool>> Contains<TElement, TValue>(this Expression<Func<TElement, TValue>> valueSelector, IEnumerable<TValue> values)
{
    if (null == valueSelector) { throw new ArgumentNullException("valueSelector"); }
    if (null == values) { throw new ArgumentNullException("values"); }
    if (!values.Any()) return e => false;

    var equals = from value in values
        select
            System.Linq.Expressions.Expression.Equal(
                valueSelector.Body,
                System.Linq.Expressions.Expression.Constant(value, typeof(TValue))
            );

    var body = equals.Aggregate((accumulate, equal) =>
        System.Linq.Expressions.Expression.Or(accumulate, equal));

    ParameterExpression p = valueSelector.Parameters.Single();
    var ex = System.Linq.Expressions.Expression.Lambda<Func<TElement, bool>>(body, p);
   
    return ex;
}

Select with EF is always slower than with Linq2SQL

This is only true when you leave the default value of ObjectQuery.MergeOption or set it to any other value but MergeOption.NoTracking. However, if you do set this value to MergeOption.NoTracking, a select will be 3 times faster than with LINQ2SQL.

The following table compares various scenarios:

So what you see here is that EDM is the fastest access after DataReader, but also the slowest if tracking is (by default) enabled. Depending on what you do, you might consider to disable Tracking for faster read access, but with the possibility of redundant data in memory.

Linq2Sql supports MS SQL only

This is not really true! Though there is currently only one IQueryProvider for MS SQL, but who prevents other SQL Provider to implement their own IQueryProvider? For instance, Oracle offers native DbConnection, DbCommand and DbReader, why not a QueryProvider?

EDM does not support UDF (User defined Functions)

Unfortunately, as with .NET 3.5 SP1 this is true. Though you can currently describe a function with

where it differs from a stored procedure by IsComposable set to true instead of false, there is currently no support for it. Usage of UDF with EF is announced to be available with .NET 4.0

Linq2SQL can do everything that EF can do and more

No. There are some features that is currently not possible with EF, but there are also features in EF that is not available with Linq2SQL.

• EF is significantly (>300%) faster in writing and updating data back to the database
• EF supports n:m relations which Linq2SQL doesn't
• Linq2SQL supports contains in query, while EF (currently) doesn't
• Linq2SQL supports UDF, EF doesn't (with Framework 3.5SP1)

Now you can use it the following way:

Now if you want to use the AttachedProperty within  a ControlTemplate you cannot simply use TemplateBinding. The following snippet shows the correct syntax.

Notice the surrounding bracket on the Path property which is mandantary as well as the appearance of Path. Thus you cannot use the following shortcut:

Rfc2898DeriveBytes

This class provides functionality to create key data from an arbitary password string, which is required for every encryption algorithm. You cannot simply convert the password string to a byte[] array using e.g. Encoding.Default.ToArray(password), since the key must  be of a specific size. The size can vary by different blocks and it depends on the algorithm you are using. For instance, the prefered AES or Rijndael algorithm requires a key size of 128, 256, 384, etc. but nothing between. Therefore you need an algorithm that encodes any string to a byte array of at least 128 bytes and not less or more.

Fortunately, this is what hashing algorithm's do! So as a replacement for the missing Rfc2898DeriveBytes, we can use a has algorithm, that belongs to the compact framework, and that creates a size that matches the requirements for the encryption algorithm. In this case, since we are  using AES, we need a hash with a size of 128 or 256, and the qualified match is the MD5 algorithm. It is not the strongest though, and SH256 would be the better choice, but unfortunately, the compact framework does not include this hash algorithm, so we need to use MD5.

 Here comes an example of how to implement encryption/decryption for windows mobile:

Almost one year ago, I decided to make all the necessary certificates to become a MCPD, a Microsoft Certified Professional Developer. This title sound like a very big honor, and indeed it is. Passing a Microsoft Certificate is not as easy as I assumed, and this is my story:

For .NET 2.0, Microsoft offers multiple grades of certificates. You need to pass 2 exams to become either a web, windows or distributed application MCTS (Microsoft certified technology specialist). All of them have the 70-536 exam in common, which in my opinion is the most difficult of them. In addition, for each of these 3 certificates you can upgrade to become a MCPD by passing one additional exam which differs for each category with one exception: for the 70-549 exam that grades you the rank of a Microsoft certified professional Developr for Enterprise Applications, you need to pass all previous MCTS certificates and this is what I'm longing for.

There are different ways to pass these exams. You can join a 2 week training course, which is about $5000, or you can simply buy the required books and make a self paced training. The books include a training software from measureup to test your knowledge. But you'd better don't rely on the knowledge you'll receive by making all 300 tests again and again and again until you memorize them. Because the real exam tests are completely different! You really need to know the issues that are included in the exam category to pass them.

It took me 3 weeks to read and prepare for the 70-536 exam, the "Application Development Foundation" which I mentioned earlier. I was also grabbing for some reports of other graduates who made this exam to figure out how exactly it works and how difficult it is. When I'd read that the real exam is supposed to be much harder than then the measureup test, I was frightened! Because the measureup test are anything else but easy! Even if you have years of .net experience like me or other developers, the questions are a pain in the ass. But on the other hand, I heard and read that the real tests are easier, they'd be obvious, and so, last week I decided to make my first exam as soon as possible and applied for a test this Monday.

This works as followed:

There are many test centers, where you can make a Microsoft exam or other exams. For a Microsoft exam (note: not a complete certificate that consists of multiple exams!) you have to pay €140 for the exam itself and additionally a fee for the test center which is about €20-30. To find a test center near your location, you first need to register at www.prometric.com then you can follow the links to the exam of your choice and select a test center at your location. Sometimes, there are more than one centers for the same city available. Next step, you choose the day of your choice when you want to make the exam (If a test center doesn't offer the date, maybe you can select another one). Finally, you select the time when you want to make the exam,which depends on the selected center. I could choose within 9:00 and 17:00. The duration of a test is scheduled to take 3:15 hours. You also can choose of the either English, French, German, Japanese or Chinese for the exam. (I chose English as my Japanese needs a little improvement).

After you have selected you're appointment, you'll receive an e-mail confirmation.

I chose Monday because it gives me a complete weekend to prepare for it. Against all odds, I was neither tensed nor I was nervous and on Sunday, I slept very well. I still was relaxed when I arrived at the test center:

So there I was, to match me intellect, to become one of the most important people of the universe.
After filing in at the reception, I had to authenticate myself with an certified document including a pass photo (usually your identity card). You can't take any book, computer, notebook, pda or cell phone to the test. If you keep one of these with you, you'll need to hand out them. Next step, guarding you to a prepared room with computers and surveillance where you'll gonna spend the next 3 hours (or maybe less) of your life. Three hours, that will change your life forever!

I still wasn't tensed or nervous when I was introduced to my computer, handing out an empty peace of paper and a pen for notes that I could make (but I was not in the mood of making any kind of notes or drawings or anything like that). Before the exam starts, you'll click trough some informations about the test and the conditions. For instance, it's not allowed to make any photos or copies of the text, or to spread them on the internet or stuff like this. You got 60 minutes or so for that, and when you feel ready, when you're of the opinion that you will make it, that the sake of the whole universe is in your hand, then you can press the final button and the exam begins. Now you have 120 minutes for 45 questions. You need to get a score of 700 of 1000, so you need to pass only 70%. But the catch is, that each question is weighted differently, so it doesn't mean that you need to have 31.5 correct questions.

After seeing the first question, I was totally calm. The question was not that difficult, so I experienced the next 4 questions. Now I was tensed! And I was nerveous! I was wondering where that steady knocking came from and I figured out that it was my heard beating! These questions have been totally knew to me and in no test that I made for preps earlier, I've seen anything similar like this! I was wondering If I do understand the question. What does it mean, what do they want from me? Why can't they leave me alone? until question 31, I was alone in the room when another candidate was introduced to that room on another computer. I heared every click he made with the mouse and it was sooo distracting. I couldn't concentrate, I was counting the pauses between a click and was wondering why he was clicking so fast! Propably another test, as my test was a lot of stuff to read and to scroll down to find a difference between answer a,b,c or d.  Anyway, I could not concentrate on the test as long as he keeps klicking all the time like a maniac!

Finally, after question 45, the last one, I had almost one hour left so I checked each question again. 10 minutes left I thought that I couldn't do more for me and the whole mankind. So I clicked the "finish" button. I was a little bit scared as the screen became white for a couple of minutes. What If all my answers are lost? What I this means I would not pass my exam?

But then there as a screen again. But it was not the result of my test! No, I now have the chance to leave comments for each question. I wanted to make some comments to some of the question where it seamed clear to select the correct answer, but I didn't find them spontaneously and I was too curious if I will have passed the exam, so I clicked finished again.

And finally, there it was, the answer of all questions, The salavation of the lost. The truth!

And the answer was "Congratulation, you passed your exam".

I was hand out a document, with the detailed result for all 7 categories of my test (but not the each question) and then I was free to go. To continue my journey on the way to become a respected MCPD.

Curious of how fast LINQ would be to filter items from a large list, I was writing a test In Visual Studio 2008 Beta 2 to determine the performance, by creating a List of a class that contains 1 million items to be filtered and sorted:

        
        // Performing a LINQ command for a list of 100.000 items:
        public IEnumerable<item> Filter(IList<item> list) 
        { 
            IEnumerable<item> items =
                from it in list where it.value < 40 || it.text.StartsWith("W")
                orderby it.text select it; 

            return items; 
        } 

                // Create a list of 1,000,000 items with random value:    
        private void button2_Click(object sender, RoutedEventArgs e) 
        { 
            List<item> items = new List<item>(); 
            Random r = new Random(); 
            Random m =new Random(); 
            for (int i = 0; i < 1000000; i++) 
            { 
                StringBuilder sb  = new StringBuilder(); 
                for (int x=0;x<10;x++) 
                { 
    
                    char c = (char)(m.Next(27)+65); 
                    sb.Append(c); 
                } 
                item item = new item(); 
                item.text = sb.ToString(); 
                item.value = r.Next(100000); 
                items.Add(item); 
            } 
   
            int t1 = Environment.TickCount; 
    
            IEnumerable<item> filtered = Filter(items); 
    
    
            bool stopped = false;
            foreach (item it in filtered) 
            { 
              if (!stopped)
              {
                int t2 = Environment.TickCount; 
                Trace.Write("Duration: "); 
                Trace.WriteLine(t2 - t1);
                stopped = true;
              }

                Trace.Write(it.value); 
                Trace.Write(" "); 
                Trace.WriteLine(it.text); 
            } 
    
        } 
    } 
    
    public class item 
    { 
        public int value; 
        public string text; 
    } 
 

To filter 1,000,000 items, it took only 631ms on a @2400GHz Core 2 Duo that was even virtualized with Virtual PC!
That's very impressive!

Note, that the LINQ result IEnumerable<item> does NOT immediately perform to filter but after the first item is request, so that explains the weired code and why I was using the stopped variable.

Today I was testing a more or less stable version of apple's safari browser. First I was eagerly trying out the rss feed functionality, and I discovered that safari does indeed support rss feed in a way that makes rss reasonable. This is a big advance in contrast to firefox. even 3.0 of firefox does not really support rss, although it claims to, it's just a useless menu point, whereas safari offers fully support like IE7 does, although IE7 is still a more nifty. Unfortunately safari lacks on websites with various rss feeds. Against IE7 that show all of then in a drop down menu, safari only offers the first grabbable rss feed.

Also a very nice feature (but more for the fun factor and not really necassary) is the nice animation, safari provides on moving a tab or layouting the toolbar buttons. In short words, it simulates an animation that vista's sidebar does, but anyway, would be a nice feature for the wow effect on IE8.

Disappointing is the search bar. as default there is google selected and you can only select yahoo but there is currently no way to use live as seach engine. so this makes actually the search bar useless. or is there really someone out there who still uses google? my recommendation to apple is not only to offer live as seach engine but also set it as the default.

Also impressive is the inline search. Against IE7, that opens a separate window for input, the safari show's a separate toolbar as soon as you press Ctrl+F and higlights a match instantly while typing the text. Both methods have their pro's and contras, and none of theme have a better usability.

But there's at least one thing that is really better than IE7: The integrated download manager. I hope that IE8 will offer this very usefull functionality, but I fear that Microsoft might get problems integrating this functionality by third party's, like always.

The global usability is not as comfortable as IE7, but it can easily compare with firefox.

So my conclusion is, that safari will become a serious threat to firefox, so at the end firefox might loose popularity. For IE7 i see no serious challenge.

Partial classes is a nice feature coming with .NET 2.0. With partial classes, it is possible to split one bigger class into separate files. For instance, Visual Studio 2005 automatically separates the business and design logic of a control class into to files: filename.cs and filename.designer.cs.

For some purposes it could be very neat to separate parts of a class that belong to a group of functionality into some more files. To do this, you simply need to create a new file, name it ClassName.addition.cs. Visual Studio 2005 treats all file names before the first point as one, so you only need to define in both files the class with the partial keyword e.g.:

public partial class MyClass

{

…

}

As I mentioned, it really makes sense, for instance, I got a form that has an edit and a display mode, so I separated the business logic of these modes into separate files, so I don't lose track of it.

Note: The vista complete pc restore is a functionality which is present on windows vista ultimate and windows vista business but not home premium or home basic

Today, when I came home from work, I had a unpleasant surprise when I was synchronizing my laptop with my pc:
At the tray, I noticed a new tray icon, so I clicked on it to find out what it is for. It opened a dialog that informed me that my Intel Raid 0 with 2 hd has detected an error on one disk and I should perform a complete backup asap. I'm using 2x250 hds and although I got a usb hd for backup purpose, this backup disk would never fit the required size. So I removed all temporary files and deleted all restore points except the latest to make size. From 260 gb of used bytes I could shrink it to 180 gb! Nice work, but still to much for my 80 gb backup drive. So I decided to abuse my windows xp computer with a 2x80 raid 0 system which I only use occasionally for windows xp testings and plugged them onto my vista computer and made my first complete backup. Other than a standard backup, the complete backup does not compress the files, so the size is indeed the same as the hd requires. It creates a *.vhd file that possibly can be used on a virtual machine like virtual pc 2007.

Now I could spend my time to attempt to solve the disk problem. What I did was simply delete the raid and recreate it again. Unfortunately, this also caused the contents of the raid getting lost, but no problem I got a backup! I restarted my pc with my windows vista ultimate dvd and instead of installing I selected the restore option, loaded the drivers for the backup raid (which was not an intel driver) from a usb stick that I've loaded from the internet with my laptop, and it detected the backup. Currently the computer is still restoring.

Finally, I got to say that this functionality is a very nice feature, because it saved me lots of time reinstalling vista and all applications again, which would take at least one day, maybe too.

Microsoft Silverlight is a new cross platform multimedia streaming client that will make the adobe flash player obsolete.

You can get more details about silverlight at the following web site:

http://www.microsoft.com/silverlight/default_01.aspx

SourceImage.cs

ImageFormats.cs

Form1.cs:

Since Windows Vista, you're familiar with this new kind of control. The breadcrumb bar was introduced with the windows explorer and replaces the combo box for the path. But the breadcrumb offers much more than only showing the path. It separates each sub folder as a breadcrumb so the user can go back with ease by just clicking the appropriate breadcrumb or selects another sibling of a breadcrumb which represents another folder inside a folder. The breadcrumb bar can also include some image buttons on the right and an icon on the left as well as a dropdown button that behaves like the dropdown button of a combo box. Even a progress bar is included in the breadcrumb bar!

You can use a breadcrumb bar not only for paths but also for other purposes. For instance in my profession I'm developing an application that shows the medical history of a patient. In the breadcrumb bar, I offer the name of the patient and also the available health insurance voucher of the patient, followed by its type, and the date separated by year, quarter or month, day that may look like this:

Miller, Max (2003-03-24) à Emergency à AOK Berlin à 2007 à November à 15

This is just one other example for what a breadcrumb bar can be used for, there are so many other possibilities. As I'm developing .NET applications, I wrote a breadcrumb bar as part of my jedi.dll assembly which also contains the previously mentioned JediGrid. Soon the jedi.dll will be available for free private use on www.tomssoftware.net, just be patient.

Here is a brief scheme of the breadcrumb bar:

.NET 2.0 offers an easy way to find any item of a generic list that is sorted by the item to get using a binary search that has an order of O(ln N). But what if you need to find an item that has not the exact value and you want to find the item that is lower/equal or higher/equal? Fortunately, the BinarySearch method also supports this situation:

BinarySearch returns the item index that matches the item to find, otherwise the return value is less than zero. But this value is a negative value that represents the nearest item that is lower than the item to search minus 2.

The following example uses this feature to find an item that is either equal or less than the index to search for:

First, a comparer class is derived that compares the items. The constructor has a parameter for the index to find instead of specifying a class for the BinarySearch method. As the BinarySearch will be parameter less, the second parameter for the Compare method will always be null and can be ignored:

        /// <summary>
        /// A comparer class to compare the groups list to find a item faster using binary search.
        /// </summary>
        class MyComparer : IComparer<MyClass>:IDisposable
        {
            public MyComparer(int index)
                : base()
            {
                this.index = index;
            }
           private int index;
 
            public int Compare(MyClass x, MyClass y)
            {
                return x.index - index;
            }
         }

The following method LowerOrEqualValue finally performs the search by creating a MyComparer class. If the result value of BinarySearch is positive or null, an item with exact the required index exists, otherwise the index is a negative value of the nearest index that is less than the specified index, so we make it positive with the formula

resultIndex = -2 – resultIndex

Note that, if there is really no item, the return value would be -1 so the formula finally would also be -1.

 
       private int LowerOrEqualValue(int index)
        {
            using (MyComparer comparer = new MyComparer (index))
            {
                int resultIndex = items.BinarySearch(null, comparer);
                if (resultIndex < 0) resultIndex = -2 - resultIndex;
                if (resultIndex >= 0 && resultIndex < resultIndex.Count)
                {
                    return resultIndex;
                }
                return -1;
            }
        }

If you don't need the next lower item but the next higher value, you just need to replace the formula by

resultIndex = -1-resultIndex

But then you must explicitly check the situation of no result when BinarySearch returns -1!

Soon I will offer a free version of the Jedi Library for download with the following contents:

• JediGrid (an optimized DataGridView with support for groups, treeview and tiles, with the fastest generic auto sorting, up to 10 times faster than other professional data grids)
• DockPanel (allows to group and nest panels with each other with the possibility to move them on runtime while performing a neat visual animation, introducing the smart placing algorithm)
• Sidebar (A combination of windows sidebar and outlook sidebar, containing sections and groups)
• GlossyRenderer (Non visual control, but provides functionality to paint neat backgrounds that are used by all controls of the Jedi library)
• BreadcrumbBar (An implementation of a breadcrumb bar as you know from window vista's explorer).

   

The library will be free of charge for private use though it is not allowed to use it for professional applications without permission!

XML Documentation on VisualStudio 2005 is a very neat thing that offers online help of the classes and its members without the need of opening the source file. But as soon as you distribute an assembly without source code, the documentation is not available when you use a class of the assembly by default. To have the documentation available that you (hopefully) created, you need to add an xml file the contains the documentation. Fortunately, to create this xml file is a piece of cake as Visual Studio 2005 does it for you. You simply need to do the following steps to enable xml documentation:

• Open the project properties
• At the Build page ensure XML Documentation file is checked:
  

• Finally simply recompile your project. But if you not have already documented all public and protected methods and classes, you will get additional warnings for those methods and classes. It's a little bit annoying to document every method even commonly known derived methods like OnPaint, but some tools like GhostDoc help to minimize the steps.

• JediGrid
• DockPanel
• GlossyRenderer
• Sidebar
• BreadcrumbBar

for for details about the JediGrid see the PowerPoint presentation:

http://www.msnusers.com/n17u6qt1kivpohh9q0l6njksc1/Documents/JediPanel2.pptx

• how serious are these reports?
• what is fact?

The truth is, the reports a right, but:

• as soon as you install a new medium for ready boost, vista analyzes the system to determine what can be extended to the external medium. This analysis requires a view minutes and does indeed consume resources so that your computer can become unhandsome.
• Also, when you reboot, this anayzing process starts when you log in, but
• Vista is designed not to shut dow when you press the exit button, but rather going in standbye or sleep mode due to the fact that meanwhile all main boards and cards supports standbye and against common opinion that standbye consumes more power thant to shut down the computer, the truth is, that there is not difference in power consumption whether you are in sleep mode or you have indeed shut down your computer. Only when you switch the button on the back of your computer, it is really off.

So I come to the result, that ready boost does what it's supposed to do, to increase the performance of your computer as long as you use you're vista computer like it was designed to be used.

Rumors that claim to say the oposite are either mistaken because of the analyzis process, or just propaganda from tux landers.

These examples show two kinds of the same code that speak for itself:

Figure 1

  static class Program 
  { 
    public static string[] Args = null; 
       /// <summary> 
    /// The main entry point for the application. 
    /// </summary> 
    [STAThread] 
    static void Main(string[] args) 
    { 
      if (Properties.Settings.Default.DebugLog) 
      { 
        /// Copy all Trace and Debug reports to columnAttrib file: 
        /// 
        string file = Properties.Settings.Default.DebugFile; 
        FileStream stream = new FileStream(file, FileMode.Create); 
        stream.Close(); 
        stream.Dispose();
        TextWriterTraceListener listener = new TextWriterTraceListener(file); 
        Trace.Listeners.Add(listener); 
        Trace.AutoFlush = true; 
        Debug.Listeners.Add(listener); 
        Debug.AutoFlush = true; 
      } 
   
      Application.EnableVisualStyles(); 
      Application.SetCompatibleTextRenderingDefault(false); 
   
      foreach (string s in args) 
      { 
        if (s.StartsWith("-locale:", StringComparison.OrdinalIgnoreCase)) 
        { 
          string culture = s.Remove(0, 8); 
          System.Threading.Thread.CurrentThread.CurrentUICulture = new System.Globalization.CultureInfo(culture); 
        } 
      } 
   
      Args = args; 
      AppLauncher launcher = new AppLauncher(); 
      launcher.Run(args); 
    } 
  }

Figure 2

  static class Program 
  { 
    public static string[] Args = null; 
   
    /// <summary> 
    /// The main entry point for the application. 
    /// </summary> 
    [STAThread] 
    static void Main(string[] args) 
    { 
      PreprareToLogDebugMessages(); 
   
      Application.EnableVisualStyles(); 
      Application.SetCompatibleTextRenderingDefault(false); 
   
      SetCultureFromParams(args); 
      Args = args; 
      AppLauncher launcher = new AppLauncher(); 
      launcher.Run(args); 
    } 
   
    /// <summary> 
    /// If Specified in the Properites Settings, all Debug and Trace outputs are 
    /// redirected to a file. 
    /// </summary> 
    private static void PreprareToLogDebugMessages() 
    { 
      if (Properties.Settings.Default.DebugLog) 
      { 
        /// Copy all Trace and Debug reports to columnAttrib file: 
        /// 
        string file = Properties.Settings.Default.DebugFile; 
        FileStream stream = new FileStream(file, FileMode.Create); 
        stream.Close(); 
        stream.Dispose();
        TextWriterTraceListener listener = new TextWriterTraceListener(file); 
        Trace.Listeners.Add(listener); 
        Trace.AutoFlush = true; 
        Debug.Listeners.Add(listener); 
        Debug.AutoFlush = true; 
      } 
    } 
   
    /// <summary> 
    /// Sets the culture for the application if specified by the args. 
    /// </summary> 
    /// <param name="args"></param> 
    private static void SetCultureFromParams(string[] args) 
    { 
      foreach (string s in args) 
      { 
        if (s.StartsWith("-locale:", StringComparison.OrdinalIgnoreCase)) 
        { 
          string culture = s.Remove(0, 8); 
          System.Threading.Thread.CurrentThread.CurrentUICulture = new System.Globalization.CultureInfo(culture); 
        } 
      } 
    } 
  } 
 

As you see in these code snippets, figure 1 looks very complicated because it's one long function that do various sub parts.

In contrast figure 2, although it contains more individual functions, it's easier to understand the meaning of the code, and as a side effect, as logical function parts are separated to a method, you can create an xml header and describe the functionality of the sub part which can be used later for automatic documentating.